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1.0 INTRODUCTION 

1.1 DESIGN OBJECTIVES 



Communication with the various components of IPL/OS is 
achieved with commands writted in a language catted System 
Command Language (SCL). This document represents a 
definition of that language and a description of the manner 
in which commands written in it are processed by the 
system. 
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1.1 a£^iGii.aBj££iiii££ 



The effect of a command language statement should not 
be surprising* i.e.* the names of commands and parameters 
should intuitively convey their meaning and there should not 
be any hidden side affects. 

The command language should be invariant to the mode of 
access e.g. local batch* remote batch and interactive. 

The command language should allow the user to 
conditionally process commands. 

The command language should allow the user to transfer 
control to a command file. 

The command language should allow the user to transfer 
control within a command file. 

The command language should provide a facility which 
allows the user to define his own commands and to locally 
redefine system supplied commands. 

User supplied commands should be indistinguishable from 
system supplied commands. 

The command language should allow the user to specify 
the parameters for any command in a positional ly independent 
as well as positional ty dependent manner. 

The command language should be insensitive to the 
manner in which the user chooses to specify values. As an 
example if an integer value is required, 511» 1FF(16) and 
2**9-l should be equally acceptable specifications. In 
general whenever a value is required* any expression 
resulting in the required value should be an acceptable 
specif ication. 
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1.0 INTRODUCTION 
1.2 TERMINOLOGY 
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1.0 INTRODUCTION 

1.3 STANDARD SYSTEM NAMES 



SYSTEM COMMAND LANGUAGE (SCL) - the language with which 
the external user communicates with the various 
comoonents of the operating system. 

LOGICAL NAME SPACE (LNS) - the name management section 
of the operating system responsible for 
maintaining descriptions of the various objects 
managed by the system. 

STANDARD INPUT FILE - the command file specitied as 
input on the SUBMIT request. The LNS descriptor 
of this file appears at the bottom of the input 
control stack in the submitted job, and the FCB of 
this file is known to the submitted job as 
JOB#INPUT. 

ALTERNATE INPUT FILE - any command file other than the 
STANDARD INPUT FILE. The LNS descriptor of this 
file appears in the input control stack* and the 
FCB of this file is known by a user supplied 

name. 

PROFILE - a permanent command file whose name appears 
in the profile catalog. These files are processed 
automatically by the system on behalf of the 
user. 

CURRENT INPUT FIUE - the command file currently being 
processed by the SCL interpreter. The LNS 
descriptor of this file appears at the top of the 
input control stack, and the FCB of this file is 
known by a user supplied name. 

SCL INPUT - the series of records read by the SCL 
interpreter on behalf of a given job. These 
records are obtained from either the standard 
input file or alternate input files. 

BASE FILE - the default working file for a given job. 

(more to be supplied) 
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1.3 STANDARD SYSTEM NAMES 



JOB#JCB - name by which a job knows its own control 
block. 

JOB^INPUT - name of the standard input file. 

JOB#DISPLAY - name of the standard display file 
(interactive) • 

JOB#PRINT - name of the standard print file. 

JOBf/PUNCH - name of the standard punch file. 

JOB#LGO - name of the standard load and go file. 

JOB^fDAYFILE - name of the job dayfile. 

IOC#INPUT - name of the stream to which records read 
from JOB^INPUT are written. This stream is 
connected by the system to JOB#DAYFILE. 

IOC#ALTERNATE - name of the stream to which records 
read from alternate input files are written. This 
stream is connected by the system to JOB#DAYFILE. 

SCLftOUTPUT - name of the stream to which normal SCL 
output is written. This stream is connected by 
the system to JOB#DISPLAY for interactive jobs, 
and to JOB#PRINT for batch fobs. 

SCL#DIAGNOSTIC - name of the stream to which SCL 
diagnostic messages are written. This stream is 
connected by the system to JGBfDISPLAY and 
JOB#DAYFILE for interactive jobs, and to JOBfPRINT 
and JOB#DAYFILE for batch jobs. 

OCS#LOG - name of the stream to which fob/operator 
messages are written. This stream is connected by 
the system to JOB#DAYFILE. 

JOB#CLOCK_LIMIT - name of the event caused by Job 

Management when the clock limit is reached. The 

standard series of commands associated with this 
event are as foliowst 

WHEN JOB#CLOCK_LIMIT 
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1.3 STANDARD SYSTEM NAMES 
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1.0 INTRODUCTION 

1.3 STANDARD SYSTEM NAMES 



DISPLAY ■*♦* CLOCK LIMIT ♦♦♦' 
TERMINATE JOB#JCB 
WHENEND 

JOB#TIME_LIMIT - name of the event caused by Job 
Management when the appropriate limit is reached. 
The standard series of commands associated with 
this event are as follows* 

WHEN JOB#TIME_LIMIT 

DISPLAY '*♦* TIME LIMIT ♦♦♦' 

TERMINATE JOB#JCB 
WHENEND 

JOB#COMPUTE_LIMIT - name of the event caused by Job 
Manage-nent when the appropriate limit is reached. 
The standard series of commands associated with 
this event are as follows! 

WHEN JOB#COMPUTE_LIMIT 

DISPLAY •♦»♦ COMPUTE LIMIT ♦♦♦' 

TERMINATE JOB#JCB 
WHENEND 

JOB#PRINT_LIMIT - name of the event caused by Job 
Management when the appropriate limit is reached. 
The standard series of commands associated with 
this event are as follows* 

WHEN JOB#PRINT_LIMIT 

DISPLAY •*♦♦ PRINT LIMIT ♦♦* • 

TERMINATE JOB#JCB 
WHENEND 

JOB#PUNCH_LIMIT - name of the event caused by Job 
Management when the appropriate limit is reached. 
The standard series of commands associated with 
this event are as followsx 

WHEN JOB#PUNCH_LIMIT 

DISPLAY •♦*♦ PUNCH LIMIT *♦♦ • 

TERMINATE JOB#JCB 
WHENEND 

SCL#BREAK - name of the event caused when tne break key 
is depressed. The standard series of commands 
associated with this event are as followst 
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WHEN SCL#BREAK 

DISPLAY • **♦ BREAK ***• 

RETURN USER 
WHENEND 

SCL#PARAM - name by which command files reference their 
values in the absence of user supplied parameter 

names. 

SCL#LANGUAGE - name of the default language for the 
job. 
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1.0 INTRODUCTION 

1.5 COMMAND AND DATA SUBMISSION 



1.^ METALANG UAG E 



The symbol i l= is read as "IS DEFINED TO BE". 

Elements enclosed by < > are to be considered a single 
syntactic unit in relation to surrounding meta symbols. 

Elements enclosed by C ] are optional and are to be 
considered a single syntactic Unit in relation to 
surrounding meta symbols. 

Elements separated by I are mutually exclusive^ and the 
symbol is read as "OR". 

Elements followed by ... can be repeated. 

<..•> will be used to indicate that an ellipsis (two or more 
periods) is required. In this case the ellipsis is part of 

the language. 



1 
2 
3 

5 
6 
7 
8 
9 
10 
11 
12 
13 
1^ 
15 
16 
17 
18 
19 
20 
21 
22 
23 
Zk 
25 
26 
27 
28 
29 
30 
31 
32 
33 
3lf 
35 
36 
37 
38 
39 
^0 
^1 
^2 
k3 
kk 
kS 

k7 
k6 



1.5 COMMAN 



SUBMISSION 



Commands and dat 
either interactive o 
terminal is used the 
the SCL interpreter, 
commands and data are 
placed on mass stora 
interpreter. The i 
storage file is cal 
file specified on the 
Manager (see Fig 1-1) 
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1.0 INTRODUCTION 

1.5 COMMAND AND DATA SUBMISSION 



The SCL interpreter 




STANDARD INPUT FILE 
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1 INTERPRETER 1 
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FILE 



the 



Fig 1-2 

Command lines are read and interpreted "on the fly" by 

SCL interpreter whereas data lines are read ^r^M 

deposited in a file without interpretation! ^ 

Command lines can be continued by placing an ellipsis 

the'cont?nuatiInM'"'- f^ '''" ""^^ ^^« ''^^' character of 
the continuation line replaces the first character of the 
ellipsis. The total number of characters must not exceed 

Example! display -This is a long character string cons... 
tant that is continued from one line to another- 
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1.0 INTRODUCTION 

1.6 WORKING ENVIRONMENT 



1.6 WORKING 



IRONHENT 



When a user establishes contact with the system an 
environment* called his working environment? is created for 
him. The characteristics of this environment are determined 
by a series of profiles which are processed by the system on 
behalf of the newcomer. This mechanism allows the system to 
create an environment for a particular user which is 
uniquely suited to the needs of that user (see Fig 1-3). 

STANDARD INPUT- FILE 





1 PROFILE 1 
1 CATALOG 1 




1 USER 1 FILE 1 
1 1 1 




1 


1 INPUT 1 
1 CONTROti 1 


1 FILE 1 

1 1 


1 STACK 1 




1 

SCL INPUT 




1 SCL 1 

1 INTERPRETER 1 




1 i 1 
1 1 1 





Fig 1-3 
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1.0 INTRODUCTION 

1.6 WORKING ENVIRONMENT 



The definition of the working environment for a given 
user is maintained in the Logical Name Space (LNS) of that 
user. The definition of the LNS for a given user is 
maintained in a table called the LNS segment list. This 
list containes the descriptors of the segments comprising 
the LNS and the order in which those segments are to be 
searched when resolving user references (see Fig 1-^). 
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Fig 1-if 
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1.0 INTRODUCTION 

1.6 WORKING ENVIRONMENT 



The "flavor" of command language a given user will 

enjoy is determined by the set of command descriptors 

contained in his LNS. The user can add and/or delete 

segments of command descriptors to achieve the desired 
repertoire (see Fig 1-5). 
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Fig 1-5 
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2.0 BASIC CONCEPTS 

2.1 CONSTANTS 



2.0 aAai£-£ONC£PIS. 



An understanding of the concepts presented in this 
section is necessary for the effective use of the System 
Command Language. 
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2.1 £OhJSIANIS 

<constant> :J= <integer> J <real> I <string> 

A constant is a data item that denotes itself» i.e.t 
its representation is both its name and its value. A 
constant does more than state a value* it demonstrates 
various characteristics of the data item. For example 
3.1^1593 shows that the constant is a real number as opposed 
to 3 which is an integer. SCL recognizes three types of 
constantst integer* real and string. 



2.1.1 INTEGER 

<integer> it= <digit> C<hex digit>...3 C C<base>n 

Integer constants can be expressed as binary, octal, 
decimal or hexadecimal representations of an integer value. 
When the base specification Is omitted 10 (decimal) Is 
assumed. It should be noted that hexadecimal 
representations must still begin with a decimal digit and 
therefore a leading zero may be required. 

Example! 123, Off(16) 



2.1.2 REAL 

<real> :J= <dlgit>... .<digit>... CE < + I - > <dlgit>...] 

Real constants are always expressed as a decimal 
representation of a real value. The decimal point must be 
internal, i.e.^ surrounded by decimal digits* 

Example: 123.^56, 1.2E-12 
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2.0 BASIC CONCEPTS 
2.1.3 STRING 
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2.0 BASIC CONCEPTS 
2.2 IDENTIFIERS 



2.1.3 STRING 



<string> SJ= 



'[ascii character]...' 



A string constant is a sequence of characters that is 
treated as a single data item. The length of a string is 
the number of characters it contains. The maximufn length of 
a string constant Is 255. Any character may appear in a 
stringt however» one internal apostrophe must be stated in 
the representation as two consecutive apostrophes. 



Example: 'abc* 



•abc' 'def ' 
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2.2 IDENTIFIER? 

<ident> J := <alpha> [<alpha> I <digit>]... 

An identifier is a string of alphanumeric characters 
not contained in a comment or constant. An identifier must 
be preceded and followed by a delimiter. The initial 
character of an identifier must not be a digit and the 
number of characters in an identifier must not exceed 31. 

Example* Xt login, task_l 
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2.0 BASIC CONCEPTS 
2.3 REFERENCE NAMES 
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2.0 BASIC CONCEPTS 
2.^ PARAMETER LISTS 



2.3 R^FERE 

<ref> Sl= 
[ (<expr>)3 3. 



[<iclent>->] 



<ident> [{<expr>)3 



[.<ident> 



Reference names are used to Identify various objects in 
the system. The simplest form of a reference name is the 
identifier and is used to identify labels and parameters. 
More complex reference names employ some combination of 
scope qualification* structure qualification and 

subscripting. 

Scooe qualification is indicated by an identifier 
followed by a right arrow digraph. The identifier is 
interpreted as the name of the LNS segment containing the 
object. For example global->x denotes the object called x 
contained within the LNS segment called global. 

Structure qualification is indicated by ah identifier 

(or subscript specification) followed by a period and 

another identifier. For example x.y denotes the object y 
contained within the structure x. 

Subscripting is indicated by an iden-tifier followed by 
a subscript. A subscript consists of an expression enclosed 
in parentheses and denotes the element of the array to be 
referenced. For example x(2) is interpreted to mean the 
second element of the array x. 

The three structuring rules defined above can be 
combined to form arbitrarly complex reference names. For 
example gl obal->x (i+4) .y is a reference to the y field of 
the i+^th element of the global array x. 

Example: LNS#GL0BAL->F1. OWNER 
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2,k PARANI 



L^iS 



Most commands require parameters to control their 
operation. These parameters are supplied by the user in a 
parameter list following the command name. 

<command name> C < Irf I , > <param list> 1 

A parameter list consists of a series of parameters 
separated by spaces or commas. The omission of a parameter 
can be indicated by two consecutive commas* however « this is 
not necessary when the parameters are specified by name. 

<param> C < bf I » > [<param>3 ]... 

Each parameter in the list can be specified in one of 
three formats. The first format is used to select options 
e.g. old/new and consists simply of the parameter name. 
The second and most common format consists of the parameter 
name followed by a value list. Both of these formats are 
positional ly independent* i.e. 9 the order in which they are 
quoted is unimportant. The third and only positional ly 
dependent format consists simply of a value list. 

<parain name> 

I <param name> < 15 I = > <value list> 

I <value list> 

A value list consists of a series of values separated 
by commas and enclosed in parentheses. When a single value 
is quoted the parentheses can be omitted. 

<value> I (<value> [ 9 <value>] • .. ) 

A value consists of a single expression representing 
the value or two expressions separated by an ellipsis 
representing a range of values. 

<expr> [<...> <expr>] 

Examplel file fl lines tl..23, ^5) 

NOTEt The positional significance of a parameter is one 
greater than the previous parameter specified in the 
list. 
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2.0 BASIC CONCEPTS 
2.5 COMMENTS 
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2.0 BASIC CONCEPTS 
2.6 STREAMS 



2.5 pOMMENTg 

<comment> i:= "[ascii character],. ." 

Comments are not interpreted by the command language 
interpreter and serve only as documentation. A comment acts 
syntactically the same els a space* i.e.* whenever a space is 
allowed a comment is allowed* and whenever a space is 
required as a delimiter a comment will serve the same 
purpose. 



Example: ..login wjh 



in the beginning 



1 
2 
3 

5 
6 
7 
8 
9 
10 
11 
12 
13 
Ik 
15 
16 
17 
IB 
19 
20 
21 
22 
23 
Zk 
25 
26 
27 
28 
29 
30 
31 
32 
33 
3k 
35 
36 
37 
38 
39 
^0 
^1 
kZ 
kZ 
kk 
k5 
kS 
kl 
<»8 



2.6 gTREAM? 



Streams are logical data sinks to which various parts 
of the system direct information. Files can be connected to 
streams in which case information directed to the stream 
will be written on the file. More than one file can be 
connected to a stream in which case information directed to 
the stream is written on all files connected to it. In 
addition a file can be connected to more than one stream In 
which case information directed to any of the streams to 
which the file is connected will be written on the file. 
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2.7 BLOCKS 1 

2 

3 

The SCL recognizes two types of blocks - LNS blocks and k 

LABEL blocks. These blocks localize the naming context for 5 

the user. 6 

7 

During job initiation an LNS block is established by 8 

the system for the job. This block forms the job local name 9 

space and in the normal case will contain most user defined 10 

names. 11 

12 

If the job is a batch job the system will also form a 13 

job local label space by establishing a label block for the 1^ 

job. In the normal case this block will contain the labels 15 

defined in the standard input file. 16 
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3.0 US£E-.ESPERTflJB£ 



The use of high level programming languages has greatly 
reduced the amount of detail the programmer must specify to 
implement a given algorithm. These languages reduce the 
amount of detail required by providing a logical environment 
in which the user operates and then mapping that logical 
environment onto the physical resources of the computer 
system. The same benifit can be realized in the area of ] ob 
control through the use ot a high level command language. 



While it is true 
problem in a shorte 
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high level language. 
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This problem is tyoic 
language escape of 
languages and can be 
request escape in the 



that the normal user can express his 
r amount of time and in a more reliable 
se of a high level language it is also 
blems can be expressed effectively in a 

This is because the amount of control 
the physical resources of the system is 
ng the mapping of his logical 
he physical resources of the system* 
ally solved by providing a machine 

some sort in the case of programming 
solved by providing an operating system 

case of a command language. 



The approach outlined above is the one that has been 
adopted for the IPL System Command Language* Th^ee logical 
environments are defined* one for the normal user* one for 
the system user and one for the system operator* These 
environments are controlled by three repertoires called the 
user, system and operator repertoires respectively* 

One important aspect of the System Command Language 
defined for IPL is its extendabi I i ty* Through the use of 
command files and procedures the user can augment the 
standard repertoires with commands suited to his particular 
requirements. These extensions are on a user by user basis 
and therefore no interference between specialized extensions 
wi II be observed. 

The repertoire defined in this section is intended to 
allow the normal user to state his requirements in a simple 
and natural manner. When more control over the system is 
required the repertoire defined in the next section must be 
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used. 

Several commands defined in this section appear in more 
than one place. These commands are applicable to more than 
one type of oblect and produce more than one type of 
result. They are documented in each area for which they 
have meaning. 
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3.0 USER REPERTOIRE 

3.1 SYSTEM ACCESS 
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3.0 USER REPERTOIRE 
3.1.2 LOCK 



3.1.1 LOGIN I LOGON I JOB 



The purpose of this command is to gain access to the 
system. The command format is as foMowsX 

login user=<ident> 

user I uJ This parameter identifies the user 

responsible for the processing. The Identifier 

specified will be looked up in the valid user 
catalog. 

When the user enters the system from an interactiwe 
terminal the system will output the followingi 

SCL VER 1.0 2130 PM MONDAY JUNE 30, 1979 
PLEASE LOGIN 



When the user enters tne system from a batch terminal 
the solicitation for input will be suppressed* 

Example! SCL VER 1.0 2X30 PM MONDAY JUNE 30, 1979 
PLEASE LOGIN 
. . login wjh 

PROFILE PROCESSING INITIATED 



3.1.2 LOCK 



The LOCK command can be used to lock the terminal to 
prevent inadvertent logout. The command format is as 
f ol t owsi 

lock terminal 
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terminal I ti This is a keyword parameter and is 
required to distinguish this variation of the LOCK 
command. 

Examplel SCL VER 1.0 2t30 PM MONDAY JUNE 30, 1979 
PLEASE LOGIN 
• . login M]h 

PROFILE PROCESSING INITIATED 
• . lock terminal 



.login ras 
TERMINAL LOCKED 
SUPPLY ID TO RESUME 



3.1.3 LOGOUT I LOGOFF I BYE I JOBEND I ENDJOB 



The purpose of this command is to relinquish access to 
the system. The command format is as follows! 

logout tuser=<ident>3 

user I ul This parameter is only required wnen the user 
has locked his terminal. In this case the 
identifier specified must match the Identifier 
specified on the LOGIN command. 

While a user is logged into the system he may issue a 
LOGIN without first issuing a LOGOUT. 
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3.1,3 LOGOUT I LOGOFF \ BYE I JOBEND I ENDJOB 
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3.0 USER REPERTOIRE 

3.2 RESOURCE RESERVATION 



ExampT eS 



SCL VER 1.0 2:30 PM MONDAY JUNE 30, 1979 
PLEASE LOGIN 
•login wjh 
PROFILE PROCESSING INITIATED 



• login ras 
AUTOMATIC LOGOUT 
CONNECT TIME = HRIMN:SC 
PROFILE PROCESSING INITIATED 



• I ogout 
CONNECT TIME 



HRJMNISC 
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3.2.1 CLAIM 



The purpose of this command is to declare the maximum 
simultaneous usage of peripheral resources. The command 
format is as folloHSt 

claim resource=(to be supplied) Cstatus=<ref >3 

resource I ri This parameter specifies the resources to 
be claimed. 

status I sJ This parameter specifies a variable into 
which the command status is to be returned. 
Omission of this parameter will cause the SCL 
error handler to be invoked upon the occurrence of 
an error condition. 

Examples {to be supplied) 
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3.2.2 RESERVE I RES 



The purpose of this command is to reserve peripheral 
units for exclusive use by the Job. The command format is 
as f ol lows: 

reserve unitset=<ref list> trej=<ref>] Cstatus=<ref >1 

unitset I ucb I u: This parameter specifies the names 
of the unit sets to be reserved. 

reject I rej I r: This parameter specifies a variable 
into which the name of the unit set causing 
rejection of the command is to be returned. 

status I s: This parameter specifies a variable into 

NCR/CDC PRIVATE REV 75/05/27 
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3,2.2 RESERVE I RES 



ADVANCED SYSTEMS LABORATORY 

IPLOS GHS - SYSTEM COMMAND LANGUAGE 



CHP030^ 



3-8 
75/05/27 



3.0 USER REPERTOIRE 
5.2,k LIMIT 



which the command status is to be returned. 

Omission of this parameter will cause the SCL 

error handler to be invoked upon the occurrence of 
an error condition. 

Example: reserve (ucbl,ucb2,ucb3) rej=r 



3.2.3 RELEASE » REL 



The purpose of this command is to release the units 

that were previously reserved by the job and return them to 

the pool of available^ units. The command format is as 
fol lowst 

release uni tset=<ref > [ status=<ref >] 

unitset I ucb I ul This parameter specifies the name of 
the unit set to be released. 

status I si This parameter specifies a variable into 

which the command status is to be returned. 

Omission of this parameter will cause the SCL 

error handler to be invoked upon the occurrence of 
an error condition. 



Example: release ucb2 



3.2.^ LIMIT 



The purpose of this command is to limit the amount of 
resources a job can consume. The command format is as 
fol lowsi, 

limit i cl ock=( hour Strainutes* sec ondsl 3 

[time= { hour Sf minutes ^seconds) 1 

[compute=(hours»roinutes» seconds) 3 C print = <expr>3 
[punch=<expr> J Cstatus=<ref >3 
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clock I cl This parameter specifies a clock time beyond 
which the job is not to be allowed to run. The 
event caused when this limit is reached is called 
JOB#CLOCK_LIMIT. 

time I tl This parameter specifies the amount of time 
the job is to be allowed to run. The event caused 
when this limit is reached is called 

JOB#TIME_LIMIT. 

computet This parameter specifies the amount of compute 
time the job is to be allowed. The event caused 
when this limit is reached is called 

JOB#COMPUTE_LIMIT. 

print : pr I pt This parameter specifies the maximum 
number of lines the Job is allowed to print. The 
event caused when this limit is reached is called 
JOB#PRINT_LIMIT. 

punch I pu: This parameter specifies the maximum number 

of cards the job is allowed to punch. The event 

caused when this I imit is reached is 
JOBffPUNCH_LIMIT. 

status I St This parameter specifies a variable into 

which the command status is to be returned. 

Omission of this parameter will cause the SCL 

error handler to be invoked upon the occurrence of 
an error condition. 

Examplet limit compute=(0,5,0) , print=2000, punch=500 
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3.0 USER REPERTOIRE 
3.3 LNS DECLARATIONS 
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3.0 USER REPERTOIRE 
3.3.1 DECLARE I DCL 



3.3 LMiJlESLLAEALIONa 

Declarations can occur explicitly when the user directs 
the system to declare a name or implicitly when the user 
references a name in a parameter list which has not yet been 
decl ared. 



3.3.1 DECLARE I DCL 



The purpose of this command is to declare a name. The 
command format is as followsi 

declare naroe=<ref list> Ctype=<ident>l [len=<expr>l 

Cdim=<expr>3 (init=<expr I ist>l Cstatus=<ref >3 

name I nt This parameter specifies the names to be 
declared. 

type I t: This parameter specifies the type of the name 
being declared. Omission of this parameter will 
cause the name to be declared as type integer. 

length I I en I l« This parameter is only meaningful 
when declaring type string. In this case it 
specifies the numoer of characters the string is 
to contain. Omission of this parameter will cause 
a default of 32 to be assumed. 

dimension I dim I dJ This parameter specifies the upper 
bounds of the array being declared. Omission of 
this parameter will cause a default of 1 to be 
assumed. 

initialize I init I i: This parameter specifies the 
initial value the name being declared is to 
assume. The number of values quoted must be equal 
to the dimension specified. 

(more to be supplied) 

status! This parameter specifies a variable into which 
the command status is to be returned. Omission of 



1 
2 
3 
k 
5 
6 
7 
8 
9 
10 
11 
12 
13 
1^ 
15 
16 
17 
18 
19 
20 
21 
22 
23 
Zk 
25 
26 
27 
28 
29 
30 
31 
32 
33 
3<» 
35 
36 
37 
38 
39 
'fO 
^1 
kZ 

45 
kS 
k7 
48 



this parameter will cause the SCL error handler to 
be invoked upon the occurrence of an error 
condition. 

Example? declare fl, type=file 



3.3.2 REMOVE 



The purpose of this command is to remove a name* The 
command format is as follows: 

remove name=<ref list> Cstatus=<ref >1 

name I nJ This parameter specifies the names to be 
removed. 

status I s> This parameter specifies a variable into 
which the command status is to be returned. 
Omission of this parameter will cause the SCL 
error handler to be invoked upon the occurrence of 
an error condition. 



Example! remove fl 



3.3.3 LNSBLOCK / LNSEND 



The purpose of these commands is to delimit an LNS 
block. An LNS block constitutes a local naming context, 
i.e. 9 the default scope of LNS names declared by the user is 
local to the LNS block in which the declaration occurs. 
Such nanes cani only be referenced from within that block or 
internally nested blocks and the life of such names is the 
life of the block in which they were declared. The general 
format of an LNS block is as follows: 
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3.0 USER REPERTOIRE 
3.3.3 LNSBLOCK / LNSEND 
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3.0 USER REPERTOIRE 
3.3.^ LNS 



Insb I ock 

Insend 

Examplei (to be suoplled) 



3.3.^ LNS 



The purpose of this command is to cause segments to be 
added to and/or deleted from the LNS segment list. The 
command format is as follows! 



Ins [delete=<ref list>1 Cold=<ref 
[status=<ref>3 



list>l Cnew=<ref 



list>l 



delete I del 1 di This parameter specifies segments 

which are to be deleted from the LNS segment 

list. All deletions will be performed prior to 
any additions. 

old I ot This parameter specifies the segments which 
are to be added to the LNS segment list without 
initialization. All segments named in this 
parameter will be added prior to any segments 
named in the new parameter. 

new I nl This parameter specifies the segments which 
are to be added to the LNS segment list and 
initialized to empty. 

status I sJ This parameter specifies a variable into 
which the command status is to be returned. 
Omission of this parameter will cause the SCL 
error handler to be invoked upon the occurrence of 
an error condition. 

note: The LNSBLOCK and LNS commands are similar in that they 
can both cause the attachment of a segment to the LNS 
segment list. They differ in that the LNSBLOCK command 
causes the attachment of a system supplied segment 
which is initialized to emptyt whereas the LNS command 
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causes the attachment of a user supplied segment with 
or without initialization. 

LNS segments are searched in the reverse order from 
which they were added to the list, i.e. whan a segment 
is added to the list it becomes the most local 
segment. Upon completion of an LNS command the current 
contents of the LNS segment list will be written on 
SCL#OUTPUT. It should be noted that an LNS command 
with no parameters will simply cause the current 
contents of the LNS segment list to be written on 
SCL<fOUTPUT. 

ExampI el ..Ins 

LNS = LNS#GLOBAL, SCLilUREP, LNS#LOCAL 
..Ins del = lns#l ocal » ol d= (pr ivrep* I ns# loca I ) 

LNS = LNS#GLOBAL, SCLtfUREP, PRIVREP, LNS#LOCAL 



3.3.5 DISPLAY I DI 



The DISPLAY command can be used to display the LNS 
descriptor of a name. The result will be. written on 
SCL#OUTPUT. The command format is as followst 

display desc = <ref> 

descriptor I desc I d» This parameter specifies the 
name whose descriptor is to be displayed. The 
parameter name is required in this case to 
distinguish this variation of the display 

command. 

Examplei ..display desc fl 
TYPE = FILE 
DIM = 1 
SIZE = 128 
ATTR = 1, 35 
DATA ADDR = 1F007C0 (16) 
DESC ADDR = 1F00500(16) 
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3.0 USER REPERTOIRE 
3.^.1 DEFINE J DEF 



3.^ COMMAND DEFItJlUQtJ 



When commands are defined to the system* a command fife 
or a procedure is associated with the command. If a command 
file is associated with a command that file will be 
processed by the system when the command Is referenced. 
This mechanism provides a procedure file capability which is 
powerful enough for most user needs. In some cases* 
however, a procedure must be associated with a command. The 
details on how to write such a procedure can be found in the 
section titled COMMAND WRITERS GUIDE. 



3.t».l DEFINE I DEF 



The purpose of this command is to define a new command 
or to redefine a system supplied command. The command has 
two formats which are as followst 

define command=<ref > file=<ref> tname=<ldent list>l 

[req=<expr list>! [fgn=<expr list>l [rng=<expr 
list>3 Cmin=<expr list>1 [max=<expr list>3 

command I ct This parameter specifies the name of the 
command to be defined. 

file I fcb I ft This parameter specifies the name of 
the command file to be processed when the command 
is referenced. 

name I nl This parameter specifies the names of the 
parameters. The positional significance of the 
parameters will be determined by the order in 
which their names are specified left to right. 
Omission of this oarameter will cause the system 
to assume a single parameter name of SCL^PARAM. 

required I req I rl This parameter specifies the set of 
required parameters. Omission of this parameter 
will cause the interpreter to assume all 
parameters are optional. 

foreign I fgn: This parameter specifies the set of 
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foreign text parameters. Omission of this 

parameter will cause the interpreter to assume 
none of the parameters expect foreign text. 

range I rng J This parameter specifies the set of range 
parameters. Omission of this parameter will cause 
the interpreter to assume none of the parameters 
expect ranges of values. 

minimum I min I mJ This oarameter specifies the minimum 
number of values required by each parameter. 
Omission of this parameter will cause the 
interpreter to assume all parameters require 1 
value. 

maximum I maxt This parameter sped fles the maximum 
number of values allowed by each parameter. 
Omission of this parameter will cause the 
interpreter to assume each parameter allows only 1 
value. 

Within the command file parameters are referenced as 
foil ows I 

<param name>. present 

This format yields a 1 if the parameter name was 
present In the list and a otherwise. 

<param name>.count 

This format yields a number corresponding to the number 
of values specified for the oarameter. 

<param name>(<value number>).low 

This format yields the value specified for the low end 
of a range. If a range was not specified this format yields 
the value that was specified. 

<param name>(<value number >) .high 

This format yields the value specified for the high end 
of a range. If a range was not specified this format yields 
the value that was specified. 
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3.0 USER REPERTOIRE 
3. it. 2 DISPLAY I DI 



Example: COLLECT CMD_FILE 

"COMPTESTS 10.. Iff WILL CAUSE THE SOURCE PROGRAMS" 
"CONTAINED IN FILES SOUiO THROUGH SOUl^ TO BE" 
"COMPILED AND THEIR OBJECT MODULES TO BE PLACED" 
"IN FILES OBJIO THROUGH OBJIV 

"CHECK RANGE" 

IF RANGECl) .LOW GE ... 

AND RANGECl) .LOW -LE ^ ANGEd ) . HIGH ... 

AND RANGE (1) .HIGH LE 99 

LNSBLOCK " LOCAL VARIABLE BLOCK " 

DECLARE (I, J, K) TYPE=INTEGER 

DECLARE DIGIT, TYPE=STRING, LEN=1, DIM=10, ,•. 
INIT=C0%'l',-2','3«,%'t'5','6','7-,-8','9-) 

DECLARE (S^FILE, 0_FILE) TYPE=STRING, LEN=5 

DECLARE TEMP, TYPE=STRING, LEN=2 

FOR I, RANGE(l) .LOW... RANGE(l) .HIGH 
"CREATE NEXT NAME IN SEQUENCE" 
J = I / 10 
K = I - J * 10 

TEMP = DIGIT(J+1) CAT DIGIT(K+1) 
S_F^ILE = -SOU* CAT TEMP 
0_FILE = 'OBJ* CAT TEMP 
DISPLAY "COMPILING ' CAT S_FILE 
FORTRAN INPUT=REF(S_FILE), OB JECT=REF (0_FILE ) 
FOREND 
LNSEND 
RETURN 
IFEND 
DISPLAY -ERROR ... INVALID RANGE* 

DEFINE COMPTESTS, FIL£=CMU_FILE, NAME=RANGE 



define command=<ref > proc=<ref > 

command I c: This parameter specifies the name of the 
command to be defined. 

procedure I proc I pJ This parameter specifies the name 
of the procedure to be executed when the command 
is referenced. 

Example: DEFINE DECLARE, PROC=SCL#LNS#DECLARE 
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3./t.2 DISPLAY I DI 



The DISPLAY command can be used to display the 
parameters of a command (command file or procedure). The 
result will be written on SCL#OUTPUT. The command format is 
as fol lows: 

display name=<ref> 

name I n: This parameter specifies the name of the 
command whose parameters are to be displayed. 

Example: ..display declare 

POSN REQ FGN RNG MIN MAX NAME(S) 



1 


YES 


NO 


NO 




5 


NAME, N 


2 


NO 


NO 


NO 




1 


TYPE, T 


3 


NO 


NO 


NO 




1 


LENGTH, LEN, L 


k 


NO 


NO 


NO 
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DIMENSION, DIM, D 


5 


NO 


NO 
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INITIALIZE, INIT, I 


6 


NO 


NO 


NO 




1 


STATUS, S 



1 

2 
3 

5 
6 
7 
8 
9 
10 
11 
12 
13 
Iff 
15 
16 
17 
18 
19 
20 
21 
22 
23 
Zk 
25 
26 
27 
28 
29 
30 
31 
32 
33 
Zk 
35 
36 
37 
38 
39 
ftO 
f*l 
kZ 
kZ 
hk 
f*5 
f*6 
kl 
f»8 



NCR/COC PRIVATE REV 75/05/27 



NCR/CDC PRIVATE REV 75/05/27 



ADVANCED SYSTEMS LABORATORY 

IPLOS GDS - SYSTEM COMMAND LANGUAGE 



CHP030^ 



3-17 
75/05/27 



3.0 USER REPERTOIRE 
3.5 FILE MANAGEMENT 
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3.0 USER REPERTOIRE 
3.5.1 ATTACH 



3.5 F ILE MANAGFM fiNT 



3.5.1 ATTACH 



The purpose of this command is to attach permanent 
files and volume sets to a job. When files are attached the 
system will establish the requestors legal access to the 
file. Evaluations of the file access control list, and the 
user id establish the type of access granted to the file. 
Once access legality has been established, the permanent 
file is attached to the job and may be used as specified by 
the ATTACH command. When volume sets are attached to a job 
they can be attached for either shared or exclusive use. 
Successful completion of the command in this case results in 
volumes being mounted, volume labels being validated, and 
optional temporary assignment of units to the Job. The 
command format is as followsl 



attach name=<ref> C usage=< ident> 1 

Cstatus=<ref >I 



[unitset=<ref >1 



name I nt This parameter specifies the name of the file 
or volume set to be attached. 

usage I use I uJ This parameter is only raea-^ingful when 
attaching files. It specifies the intended use of 
the file. The valid specifications for this 
parameter are as follows: 

ER - exclusive read or execute access 

EW - exclusive write access 

EP - exclusive private write access 

SR - shared read or execute access 

SW - shared write access 

SP - shared private write access 

"Exclusive" access Tieans that multiple exclusive 
readers or one exclusive writer may have the file 
attached simultaneously. "Shared" access means 
that multiple shared readers and writers may have 
the file attached simultaneously. "Private write" 
means the user can write on the file but the 
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changes are not written back to the master file. 
All changed blocks of the file are kept local to 
the user. See the Data Management section on 
concurrent access control for additional 
information. 



unitset I ucb: This parameter 
attaching volume sets, 
the unit set describing 
volumes are to be mi 
parameter is only ailowe 
sets and implies that 
attached for shared us 
internal table is refe 
set has already been att 
another job. If it ha 
I inked direct ly to it 
attached the volume s 
the command is rejected 
currently attached to an 
on-line, units are tempo 
volumes are mounted. 



is only meaningful when 

It specifies the name of 

the units on which the 

unted. Omission of this 

d for mass storage volume 

the volume set is being 

with other jobs. An 

renced to deter*mine if the 

ached for shared use by 

s, then the current job is 

If a previous job has 

et for exclusive use, then 

If the volume set is not 

y job and is not currently 
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status I St This parameter specifies a variable into 

which the command status is to be returned. 

Omission of this parameter will cause the SCL 

error handler to be invoked upon the occurrence of 
an error condition. 

Example: attach fl, use=sr 



3.5.2 DETACH 

The purpose of this command is to sever the connection 
between a job and a file or volume set. If a temporary file 
is being detached, it is deleted from the system and the 
resources allocated to it are released. If a permanent file 
is being detached, it is no longer accessible to the job but 
the definition and contents of fhe file still exist. If a 
volume set is being detached, the units to which the set was 
attached are not released if the units were reserved by the 
current job. If the units were temporarily assigned because 
of attaching the volume set for shared use, and if no other 
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jobs are currently attached. to the set, then the units are 
returned to the available pool. The command format is as 
fo I I ows i 

detach name=<ref> [status=<ref > J 

name I n: This parameter specifies the name of the file 
or volume set to be detached. 

status I s* This parameter specifies a variable into 
which the command status is to be returned. 
Omission of this parameter will cause the SCL 
error handler to be invoked uoon the occurrence of 
an error condition. 

Example? detach fl 



3.5.3 CREATE 



The purpose of this command is to define a new file to 
the file management system. All oarameters that are 
required to describe the file are located in the file 
control block. System default values for the parameters may 
be supplied if the user has not explicitly supplied a 
value. Resources requl-red by the file are allocated to the 
file at this time. If the file is defined to be permanent, 
an entry is made in the appropriate file catalog. The 
command format is as follows: 



create f i I 



=<ref> [status=<ref >] 



file I fcb I f: This parameter specifies the 
the file to be created. 



name of 



status I s: This parameter specifies a variable into 

which the command status is to be returned. 

Omission of this parameter will cause the SCL 

error handler to be invoked upon the occurrence of 
an error condition. 

Examples create fl 
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3.5.^ DELETE I DEL 



The purpose of this command is to remove the definition 
of a permanent file from the file catalog. If the file is 
not currently attached to a Job, the file label in the 
catalog is deleted and the resources allocated to the file 
are released. If the file is currently attached to a Job, 
the status of the file is changed to a temporary file. The 
command format is as followst 

delete file=<ref> [status=<ref >1 

file I fcb I f: This parameter specifies the name of 
the file to be deleted. 

status I si This parameter specifies a variable into 
which the command status is to be returned. 
Omission of this parameter will cause the SCL 
error handler to be invoked upon the occurrence of 
an error condition. 



Example: delete fl 



3.5.5 SAVE 



The purpose of this command is to convert a temporary 
file to a permanent file. Since all the space allocation 
and consistency checks on logical file characteristics were 
performed by previous CPEATEF or EXPANDF requests, the major 
remaining effort is to construct a file label and enter it 
in a catalog. The file itself is not copied but rather 
remains where it was originally allocated. The command 
format is as follows: 

save file=<ref> [ stat us=<ref >] 

file I fcb I f: This parameter specifies the name of 
the file to be saved. 

status I s: This parameter specifies a variable into 
which the command status is to be returned. 
Omission of this parameter will cause the SCL 
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3.0 USER REPERTOIRE 
3.5,7 PRINT I PR 



error handler to be invoked upon the occurrence of 
an error condition. 



Examplet save fl 



3.5.6 DISPLAY I DI 



The DISPLAY command can be used to display a file. The 
content of the file specified will be written on 
SCL#OUTPUT. The command format is as fol lowst 

display Cname=<ref>] 

name I nt This parameter specifies the name of the file 
to be displayed. Omission of this pa-^ameter will 
cause the base file to be displayed. 



Example* ..display fl 

This is the 1st I ine 

This is the 2nd line 

This is the 3rd I ine 



3.5.7 PRINT I PR 



The PRINT command can be used to print a file. The 
content of the file specified will be written on JOB^PRINT. 
The command format is as follows: 

print tname=<ref>] [ f orm=<expr >3 [ copies=<expr >1 

name I ns This parameter specifies the name of the file 
to be printed. Omission of this parameter will 
cause the base file to be printed. 

form 5 fl This parameter specifies the form on which 
the file is to be printed. Omission of this 
parameter will cause the site default to be used. 
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copies I c: This parameter specifies the number of 
copies to be printed. Omission of this parameter 
will cause 1 copy to be printed. 

ExampI e : print f 1 



3.5.8 PUNCH I PU 



The purpose of this command is to punch a file. The 
content of the file specified will be written on JOB#PUNCH. 
The command format is as follows: 

punch [file-<ref>] 

file I fcb I f: This parameter specifies the file to be 
punched. Omission of this parameter will cause 
the base file to be punched. 



Example: punch fl 
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3.6 FILE_ R OUTING 



3.6.1 ROUTE 



The purpose of this command is to initiate the 
transmittal of a fiJe to some destination. The command 
format is as follows: 

route file=<ref> Cdest=<ref>3 tf orm=<expr>3 [copies=<expr>3 
tstatus=<ref >J 

file I fcb I ft This parameter specifies the name of 
the file to be routed. 

destination I dest I dl This parameter specifies the 
destination of the file. Omission of this 
parameter will cause the file to be rauted to the 
printer. 

The destination specified on a route or direct 
command becomes associated with a particular unit 
via the ONSYSTEM command described under operator 
communication. 

form: This parameter specifies the physical properties 
of the output medium (e.g. paper size, card type* 
printer train* ribbon color) upon which the data 
is to be placed. Omission of this parameter will 
cause a default to be assumed. 

copies J c: This parameter specifies the number of 
copies to be placed on the output unit. Omission 
of this parameter will cause a default value to be 
assumed. 

status I s: This parameter specifies a variable into 
which the command status is to be returned. 
Omission of this parameter will cause the SCL 
error handler to be invoked upon the occurrence of 
an error condition. 

Example: route fl, dest=ses 
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permit the 
This command 
initiates 



3.6.2 DIRECT 



The purpose of this command is to 
specification of a destination for a file. 
differs from the previous command in that ROUTE 
the transmittal of a specified file to a specified 
destination whereas DIRECT informs Job Management that upon 
job termination a specified file is to be transmitted to a 
specified destination. The command format is as follows: 

direct file=<ref> [dest=<ref>J [ f orm=<expr>] Ccopies=<expr>] 
[status=<ref >] 

file I fcb I f: This parameter specifies the name of 
the file to be directed. 

destination I dest I d: This parameter specifies the 
destination of the file. Omission of this 
parameter wiM cause the file to be directed to 
the printer. 

form: This parameter specifies the physical properties 
of the output medium (e.g. paper size* card type* 
printer train, ribbon color) upon which the data 
is to be placed. Omission of this parameter will 
cause a default to be assumed. 

copies I c: This parameter specifies the number of 
copies to be placed on the output unit. Omission 
of this parameter will cause a default value to be 
assumed. 

status I s: This parameter specifies a variable into 
which the command status is to be returned. 
Omission of this parameter will cause the SCL 
error handler to be invoked upon the occurrence of 
an error condition. 



Example: direct fl, dest=as Ic^os 
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3.6.3 RETRACT 



The purpose of this command is to countermand < 
previous DIRECT command. The command format is as foMowst 



retract file=<ref> 



file I fcb I f: This parameter specifies the file which 
was previously directed. 



Example: retract fl 
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3.7 IiALA_INPiiI 



3.7.1 COLLECT t COL 



The purpose of this command is to collect data from SCL 
INPUT. The command format is as follows: 

collect [file=<ref>3 tunt i I =<expr> ] 

file I fcb I f: This parameter specifies the name of a 
file into which the data is to be placed. 
Omission of this parameter will cause the data to 
be placed in the base file. 

until I uJ This parameter specifies a string .containi ng 
an end of data delimiter. Omission of this 
parameter will cause a default of ♦♦ to be 
assumed. 

Example: ..collect fl until •/♦• 

SUPPLY RECORDS 
..This is the 1st line 
..This is the 2nd line 
. .This is the 3rd I ine 
../♦ 

RECORDS COLLECTED 
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3.8 SIB£AM_MAM£EM£tlI 



The figures shown below reflect the standard stream 
connections established by the system for a job. The user 
can» of course, alter the connections at any time. 

INTERACTIVE JOB 



JOB#INPUT 



_>l 



_> IOC#INPUT 



ALTERNATE INPUT 



I SCL INTERPRETER I 

"I I > lOC/^ALTERNATE 

I I 



/ I \ 

/ I \ 

i 11 

SCL#OUTPUT I I 

I SCL#DIAGNOSTIC I 
I I OCS#LOG 

I I I 

J 0B# DISPLAY < V V I 

I I 

JOB#PRINT I I 

I 1 

JOB#DAYFILE < V V 



Fig 3-1 



J/Ji 
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BATCH JOB 



JOB#INPUT 



ALTERNATE INPUT 



I SCL INTERPRETER I 

_>l L 

I •■ I 



_> lOCtflNPUT 



> IOC#ALTERNATE 



I 



JOB#PRINT <_ 



SCLtfOUTPUT I 

I SCL#OIAGNOSTIC I 
I I OCS^LOG 
I I I 
V • V I 

I I 



JOB^DAYFILE <_ 



_V_V 



Fig 3-2 

The connections shown in Fig 3-1 are established by 
profile containing the commands shown below. 

DECLARE lOCfflNPUT, TYPE=STREAM 
CONNECT IOC#INPUT, JOB#DAYFILE 
DECLARE lOC^ALTERNATE, TYPE=STREAM 
CONNECT IOC#ALTERNATE, JOBSDAVFILE 
DECLARE SCL<^OUTPUT, TYPE=STREAM 
CONNECT SCL#OUTPUT, JOB#OISPLAY 
CONNECT SCL#OUTPUT, JOB#DAYFILE 
DECLARE SCL#DIAGNOSTIC, TYPE=STREAM 
CONNECT SCL#DIAGNOSTIC, JOB#DISPLAY 
CONNECT SCL#DIAGNOSTIC, JOB#DAYFILE 
DECLARE OCS#LOG, TYPE=STREAM 
CONNECT OCS#LOG, JOB#DAYFILE 



The connections shown in Fig 3-2 are established 
profile containing the commands shown below. 



by a 



DECLARE 
CONNECT 
DECLARE 
CONNECT 
DECLARE 
CONNECT 
CONNECT 
DECLARE 
CONNECT 



IOC#INPUT, 

IOC#INPUT, 

IOC#ALTERNA 

lOC^ALTERNA 

SCL#OUTPUT, 

SCL#OUTPUT, 

SCL#OUTPUT, 

SCL/^DIAGNOS 

SCL/^DIAGNOS 



TYPE=STREAM 
JOB#DAYFILE 
TE, TYPE=STREAM 
TE, JOB^DAYFILE 
TYPE=STREAM 
JOBi^PRINT 
JOB#DAYFILE 
TIC, TYPE=STREAM 
TIC, JOB#PRINT 
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CONNECT SCLffUIAGNOSTIC, JOBtfDAYFILE 
DECLARE OCStfLOG, TYPE=STREAM 
CONNECT OCStfLOG, JOB^OAYFILE 



3.8.1 CONNECT 1 CON 



The purpose of this command is to establish a 
connection between a stream and a file. The command format 
is as f ol lowsi 

connect stream=<ref> file=<ref> status=<ref> 

stream I scb I s: This parameter specifies the stream 
to be connected. 

file I fcb I ft This parameter specifies the file to be 
connected. If the file specified is not currently 
connected to any streams the file will be 
connected and opened for output. 

status! This parameter specifies a variable into which 
the command status is to be returned. Omission of 
this parameter will cause the SCL error handler to 
be invoKed upon the occurrence of an error 
condit ion. 

Example! ..connect stream=sc l#a Itarnate? f i I e=j ob#displ ay 



3.8.2 DISCONNECT I DISCON 



The purpose of this command is to sever the connection 
between a stream and a file. The command format is as 
f o i I owss 

disconnect stream=<ref> file=<ref> status=<ref> 

stream I scb I si This parameter specifies the stream 
to be disconnected. 
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file I fcb I ft This parameter specifies the file to be 
disconnected. If the file specified is not 
currently connected to any other streams the file 
will be disconnected and closed. 

status? This parameter specifies a variable into which 
the command status is to be returned. Omission of 
this parameter will cause the SCL error handler to 
be invoked upon the occurrence of an error 
condition. 



3.8.3 DISPLAY I DI 



The DISPLAY command can be used to display the current 
status of a specified stream. The result will be written on 
SCL#OUTPUT. The command format is as followss 

display status=<ref> 

status I sJ This parameter specifies the name of the 
stream whose status is to be displayed. 

Example: ..display status scl#output 
TYPE = STREAM 
CONNECTIONS = JOB#QISPLAY, JOB#DAYFILE 
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3.9 PROG 



Although the standard language translators can be 
executed as normal tasks* because of their common uset 
specialized commands are supplied to facilitate their 
invocation. 



3.9.1 FORTRAN I FORT I FTN 



The 
compi I er. 



fortran 



purpose of this command is to invoke the Fortran 
The command format is as foMowst 



tinput=<ref>l [list=<ref>] 

topt=<ident list>] [status=<ref > 3 



Cob3ect=<ref >3 



input I inp I it This parameter specifies the name of 
the file containing the source program to be 
compiled. Omission of this parameter will cause 
the base file to be compiled. 

listing I list I i: This parameter specifies the name 
of the file on which the listing is to be 
written. Omission of this oarameter will cause 
the listing to be written on JOB#PRINT. 

object 1 obj I oi This oarameter specifies the name of 
the file on which the object module is to be 
written. Omission of this parameter will cause 
the object module to be written on the JOB#LGO. 

option I opt* This parameter specifies a list of 
compiler options. The Fortran compiler provides 
the following optionst 

SL I NSL - source list 

AL 1 NAL - assembly I ist 

CR I NCR - cross reference 

MM I NMM - memory map 

OM I NOM - object module 

OP 1 NOP - optimization 

UB I NDB - debug tab les 

SC I NSC - syntax check only 
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status I sJ This parameter specifies a variable into 
which the command status is to be returned. 
Omission of this parameter will cause the SCL 
error handler to be invoked upon the occurrence of 
an error condition. 

Example: ftn inp=fl, opt={s l»cr»om) 



3.9.2 COBOL I COB 



The purpose of this command is to invoke the Cobol 
compiler. The command format is as follows! 

cobol [input=<ref >1 C I ibrary=<ref> 1 Clist=<ref>] Cdgn=<ref>l 
Cob ject=<ref >3 [opt=<ident list>l £status=<r ef>] 

input I inp 1 ii This parameter specifies the name of 
the file containing the source program to be 
compiled. Omission of this parameter will cause 
the base file to be compiled. 

library I I ib 1 Ix This parameter spe'cifies the name of 
the source statement library to be used during 
compilation. 

listing I listi This parameter specifies the name of 
the file on which the listing is to be written. 
Omission of this parameter will cause the listing 
to be written on JOBtfPRINT. 

diagnostic I dgn I dt This parameter specifies the name 
of the file on which the diagnostic messages 
generated by the compilation are to be written. 
Omission of this oarameter will cause the 
diagnostic messages to be written on the list 
file. 

object I obj I ot This parameter specifies the name of 
the file on which the object module is to be 
written. Omission of this parameter will cause 
the object module to be written on the JOBtfLGO. 

option I opt: This parameter specifies a list of 
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SL 1 


1 NSL 


AL 


1 NAL 


CR 


t NCR 


MM ■ 


J NMM 


OM 


J NOM 


FG 


1 NFG 


DB 


i NOB 


SC 


1 NSC 


BC 1 


1 NBC 


PG 1 


1 NPG 


AV i 


1 NAV 


TR 1 


1 NTR 


NS 1 


1 NNS 



compiler options. The Cobol compiler provides the 
following options! 

source list 

assembly list 

cross reference 

memory map 

object module 

force generation 

debug tables 

syntax check only 

bounds check 

propogated diagnostics 

advisory diagnostics 

trivial diagnostics 

non standard usage diagnostics 

status I sJ This parameter specifies a variable into 
which the command status is to be returned. 
Omission of this parameter will cause the SCL 
error handler to be invoked upon the occurrence of 
an error condition. 

Example* cobol inp=fi, obj=f2 



3.9.3 SWL 



The purpose of this command is to invoke the SWL 
compiler. The command format is as followst 

swi [input=<ref >] tlist=<ref>1 Cob ject=<ref >] Copt=<ident 
list>] [status=<ref>3 

input I inp I iJ This parameter specifies the name of 
the file containing the source program to be 
compiled. Omission of this oarameter will cause 
the base file to be compiled. 

listing I list t It This parameter specifies the name 
of the file on which the listing is to be 
written. Omission of this parameter will cause 
the listing to be written on JOB#PRINT. 
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object I Ob) I oi This parameter specifies the name of 
the file on which the object modjie is to be 
written. Omission of this parameter will cause 
the object module to be written on the JOB#LGO. 

option I opt* This parameter specifies a list of 
compiler options. The. SWL compiler provides the 
fo I lowing options: 

(to be supplied) 

status I s: This parameter specifies a variable into 

which the command status is to be returned. 

Omission of this parameter will cause the SCL 

error handler to be invoked upon the occurrence of 
an error condition. 

Example! swI inp=fl» Iisting=f2 



3.9.^ COMPILE I COMP 



The purpose of this command is to compile a program. 
The compiler selected will be determined by examining the 
data type attribute in the file control block of the input. 
If the data type is undefined the selection will be 
determined by the contents of the job local variable called 
SCL#LANGUAGE. The command format is as followst 

compile [ input=<ref>T Clist=<ref>3 £ obj ect=<ref >1 

[opt=<ident list>l [status=<ref>l 

input I inp I it This parameter specifies the name of 
the file containing the source program to be 
compiled. Omission of this parameter wil I cause 
the base file to be compiled. 

listing I list I It This parameter specifies the name 
of the file on which the listing is to be 
written. Omission of this parameter will cause 
the listing to be written on JOBffPRINT. 

object I obj I ot This parameter specifies the name of 
the file on which the object module is to be 
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written. Omission of this parameter will cause 
the object module to be written on the JOB#LGO. 

option \ optt This parameter specifies a list of 
compiler options. Which options are meaningful 
will depend on which compiler is invoked. An 
attempt will be made to retain consistency between 
the compiler options where possible* i.e. if a 
given compiler provides an option for source 
listing generation the option will be specified by 
an S or NS in the option parameter. 

status I s: This parameter specifies a variable into 

which the command status is to be returned. 

Omission of this parameter will cause the SCL 

error handler to be invoked upon the occurrence of 
an error condition. 

Example* comp inp=fl» ob]=f2 



1 
2 
3 
k 
5 
6 
7 
8 
9 
10 
11 
12 
13 
1^ 
15 
16 
17 
18 
19 
20 
21 
22 
23 
2^ 
25 
26 
27 
28 
29 
30 
31 
32 
33 
.34 
35 
36 
37 
38 
39 
40 
kl 
42 
43 
44 
45 
46 
47 
48 



3.10 P ROGRA M 



3.10.1 LIBRARY I LIB 



The purpose of this command is to cause entries to be 
added to and/or deleted from the loader library list. The 
command format is as followst 

library [delete=<ref list>] Cadd=<ref list>3 C status=<ref>1 

delete I del I d: This parameter specifies the names of 
the libraries which are to be deleted from the 
library list. All deletions will be performed 
prior to any additions. Omission of this 
parameter will cause no deletions to be made. 

add I at This parameter specifies the names of the 
libraries which are to oe added to the library 
list. The libraries are searched in the order in 
which they are added to the list. Omission of 
this parameter will cause no additions to be 
made. 

status 1 si This parameter specifies a variable into 
which the command status is to be returned. 
Omission of this parameter will cause the SCL 
error handler to be invoked upon the occurrence of 
an error condition. 

NOTE* Upon completion of a LIBRARY command the current 
contents of the library list will be written on 
SCL<^OUTPUT. It should be noted that a LIBRARY command 
with no parameters will simply cause the current 
contents of the library list to be written on 
SCL#OUTPUT. 



ExampI e: 



. I ib ( libl, Iib2) 

LIB = SYS#LIB, LIBl, LIB2 
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3.10.2 OBJECT I OBJ 



The purpose of this command is to add and/or delete 
entries from the loader object list. The command format is 
as foil ows I 

object Cdelete=<ref list>3 [add=<ref list>l [status = <ref > 1 

delete J del I d» This parameter specifies the names of 
the files v^hich are to be deleted from the object 
list. All deletions will be performed prior to 
any additions. Omission of this parameter will 
cause no deletions t o be made. 

add I at This parameter specifies the names of the 

files which are to be added to the object list. 

Omission of this parameter will cause no additions 
to be made. 

status I St This parameter specifies a variable into 
which the command status is to be returned. 
Omission of this parameter will cause the SCL 
error handler to be invoked upon the occurrence of 
an error condition. 

NOTEt Upon completion of the OBJECT command the current 
contents of the object list will be written on 
SCL#OUTPUT. It should be noted that an OBJECT command 
with no parameters will simply cause the current 
contents of the object list to be written on 
SCL#OUTPUT. 



ExampI et 



.obj d=testl» a=test2 
OBJ = JOB#LGO, TEST2 



3.10.3 EXECUTE I EXEC I XEQ 



The purpose of this command is to cause the named 
program to be loaded and executed as a tasK. For a 
description of the libraries and object files used by the 
loader see the LIBRARY and OBJECT command descriptions. The 
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command format is as followst 

execute program=<ident> [oaram=<expr I ist>1 Ctask=<ref>J 
[event=<ref >1 tstatus=<ref > 1 

program I prog I pcb I pt This parameter specifies the 
name of the program to be executed. 

parameter I paramt This parameter specifies a list of 
values which are to be passed to tie executed 
program. Omission of this parameter will cause a 
null value list, to be passed. 

task I tcb I tt This parameter specifies tne name by 
which the new task is to be known. Omission of 
this parameter will cause the system to supply a 
name» however, since this name will not be known 
by the user no control over the processing of that 
task will be possible. 

event I ecb I et This parameter specifies the name of 
an event which is to be caused upon task 
termination. Omission of this parameter will 
cause the SCL interpreter to await the termination 
of the task before returning control to the user. 

status I St This parameter specifies a variable into 
which the command status is to be returned. 
Omission of this parameter will cause the SCL 
error handler to be invoked upon the occurrence of 
an error condition. 

Examplet ..lib fl 

LIB = SYS#LIB, Fl 
..execute prog=main» param=(x,y), task=tl 



3. 10. if STOP 



The stop command can be used to stop the processing of 
a specified task. The command format is as followst 



stop name=<ref> [ stat us=<ref >] 
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name I n: This parameter specifies the name of the tasK 
which is to be stopped. If the tasK specified is 
already stopped no operation will take place. 

status I si This parameter specifies a variable into 

which the command status is to be returned. 

Omission of this parameter will cause the SCL 

error handler to be invoked upon the occurrence of 
an error condition. 

Examplel stop tl 



3.10.5 START 



The start command can be used to restart the processing 
of a stopped task. The command format is as follows! 

start name=<ref> tsta tus=<ref > 1 

name I ni This parameter specifies the name of the task 
which is to be started. If the task specified is 
already in a started state no operation will take 
place. 

status I st This parameter specifies a variable into 

which the command status is to be returned. 

Omission of this parameter will cause the SCL 

error handler to be invoked upon the occurrence of 
an error condition. 

Example* start tl 



3.10.6 TERMINATE I TERM 



The terminate command can be used to terminate 
processing of a specified task. The command format is as 
fol lowsl 
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terminate name=<ref> Cstatus=<ref > ] 

name I nt This parameter specifies the name of the task 
which is to be terminated. 

status I sJ This parameter specifies a variable into 
which the command status is to be returned. 
Omission of this parameter will cause the SCL 
error handler to be invoked upon the occurrence of 
an error condition. 

Examplel term tl 



3.10.7 DISPLAY 



DI 



The DISPLAY command can be used to display the current 
status of a specified task. The result will be written on 
SCL#OUTPUT. The command format is as followsl 

display status=<ref> 

status I si This parameter specifies the name of the 
task whose status is to be displayed. 

Examplel ..display status tl 
TYPE = TASK 
CONDITION = EXECUTING 
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3.11.1 SUBMIT 



The purpose of this command is to submit a new job to 
the system. The command format is as fol lowsl 



submit 



C input=<ref >] Cparam=<va lue 
tevent=<ref >3 tstatus=<ref >3 



list>3 C}ob=<ref>3 



input \ inp I iJ This parameter specifies the name of 
the file which is to serve as the standard input 
for the submitted job. Omission of this parameter 
will cause the base file to be submitted. 

parameter I param I pi This parameter specifies a list 
of values which are to be passed to the submitted 
job. Omission of this parameter will cause a null 
value list to be passed. 

job I jcb I ji This parameter specifies the name by 
which the submitted job is to be known. Omission 
of the job parameter will cause the system to 
supply a name to the submitted job» however, since 
this name will not be known to the user no control 
over the processing of that job will be possible. 

event I ecb I e: This parameter specifies the name of 
an event which is to be caused upon job 
termination. Omission of the event parameter will 
mean that no indication of the termination of the 
submitted job will be received by the submitting 
job. 

status 1 St This parameter specifies a variable into 
which the command status is to be returned. 
Omission of this parameter will cause the SCL 
error handler to be invoked upon the occurrence of 
an error condition. 

Example: submit fl, job = jl 
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Within the submitted job parameters are referenced as 
fol lows< 

SCL#PARAM. count 

This format yields a number corresponding to the number 
of values passed to the job. 

SCL#PftRAM(<value number» 

This format yields the nth value specified where n is 
the value number quoted. • 



3.11.2 STOP. 



The stop command can be used to stop the processing of 
a specified job. The command format is as follows! 

stop name=<ref> [ stat us=<ref >] 

name I nl This parameter specifies the name of the Job 
which is to be stopped. If the job specified is 
already stopped no operation will take place. 

status I sx This parameter specifies a variable into 
which the command status is to ba returned. 
Omission of this parameter will cause the SCL 
error handler to be invoked upon the occurrence of 
an error condition. 

Examples stop jl 



3.11.3 START 

The start command can be used to restart the processing 
of a stopped job. The command format is as fol lows! 

start name=<ref> [status=<ref > 1 

NCR/CDC PRIVATE REV 75/05/27 
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name I nt This parameter specifies the name of the Job 
which is to be started. If the }ob specified is 
already in a started state no operation will take 
place. 

status I St This parameter specifies a variable into 
which the command status is to be returned. 
Omission of this parameter will cause the SCL 
error handler to be invoked upon the occurrence of 
an error condition. 

Examples start jl 



3.11.^ TERMINATE I TERM 



The terminate command can be used to terminate 
processing of a specified job. The command format is as 
fol lowst 

terminate name=<ref> Cstatus=<ref > 1 

name I nt This parameter specifies the name of the Job 
which is to be terminated. 

status I St This parameter specifies a variable into 
which the command status is to be returned. 
Omission of this parameter will cause the SCL 
error handler to be invoked upon the occurrence of 
an error condition. 



Exampiet term Jl 



3.11.5 DISPLAY I DI 



The DISPLAY command can be used to display the current 
status of a specified job. The result will be written on 
SCL#OUTPUT. The command format is as followst 
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display status=<ref> 

status I St This parameter specifies the name of the 
job whose status is to be displayed. 

Exampiet ..display status jl 
TYPE = JOB 
CONDITION = TERMINATED 
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3.12 £^£NI_tlANlI2LIN£ 



3.12.1 TIMER 



The purpose of this command is to inform the system 

timer that a specified event is to be caused upon 

satisfaction of a specified condition. The command format 
is as f ol lows! 

timer event=<ref> Cc I ock= (hour»minute ^second) 1 

ttime=(hour,minutef second) ] 
[compute=(hour»minute»second) ] 

event I ecb I el This parameter specifies the name of 
the event which is t o be caused* 

clock I ci This parameter specifies a clock time at 
which the specified event is to be caused. If the 
time specified has already passed the event wilt 
be caused immediately. 

time I ti This parameter specifies an amount of real 
time after which the specified event is to be 
caused. 

computet This parameter specifies an amount of compute 
time spent on this job after which the specified 
event is to be caused. 

Example: timer de I ay_30_mi I s, t ime = ( Of 0, 0. 030) 



3.12.2 WHEN / WHENEND 



The purpose of these commands is to delimit a series of 
commands which are associated with a specified condition. 
The command format is as follows: 
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when condi tion=<expr> 



condition I cond I cl This parameter specifies a 
logical expression which will determine when the 
commands between the WHEN and WHENEND are to be 
processed. When the expression becomes true 
(non-zero) they will be processed. 

Example: ..lib fl 

LIB = SYS#LIB, Fl 

execute prog=mainf task=tlt event=el 
timer e2t time=(0»5»0) 
when el or e2 
if el 

clear el 

display "task complete' 
if end 
if e2 

clear e2 
stop tl 

display 'task stopped at ' CAT clock(arapm) 
ifend 
whenend 



3.12.3 WAIT 



The purpose of this command is to await a specified 
condition. The command format is as follows: 

wait condition=<expr> 

condition I cond I c: This parameter specifies a 
logical expression which will determine when 
control will be returned to the user. When the 
expression becomes true (non-zero) control will be 
returned. 
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Example: . . I lb f 1 

LIB = SYS#LIB, Fl 
..execute main» event =er^dl_of_main 



•.wait end_of main 



3. 12. if CAUSE 



The purpose of this command i s to cause the occurrence 
of a specified event. The command format is as followst 

cause event=<ref> 

event I ecb I el This parameter specifies the name of 
the event which is to be caused. If the event 
specified is already in a caused state no 
operation will take place. 

ExampI et . .when el 

.. clear el 

•. display 'el occurred at • cat clocK(ampm) 

..whenend 



•.cause el 

el occurred at 2J30 pm 



3.12.5 CLEAR ' 



The purpose of this command is to clear a specified 
event. The command format is as followst 

clear event=<ref> 



1 
2 
3 
k 
5 
6 
7 
8 
9 
10 
11 
12 
13 
1^ 
15 
16 
17 
18 
19 
20 
21 
22 
23 
Zt* 
25 
26 
27 
28 
29 
30 
31 
32 
33 
2k 
35 
36 
37 
38 
39 
^0 
^1 
kZ 
t*Z 
kk 
k5 
kS 
k7 
tf8 



event I ecb I es This parameter specifies the name of 
the event which is to be cleared. If the event 
specified is already in a cleared state no 
operation will taKe place. 

Example! clear el 



3.12.6 ENABLE 



specified 



The purpose of this command is to enable 

event. The command format is as f ol lowsi 

enable event=<ref> 

event I ecb \ el This parameter specifies the name of 

the event which is to be enabled. If the event 

specified is already in a enabled state no 

operation will take place. 

Examplel enable el 



3.12.7 DISABLE 



The purpose of this command is to disable a specified 
event. If an event is caused while it is disabledt any 
outstanding WHEN commands which rely upon the event will not 
be honored until the event is enabled. The command format 
is as fol lowst 



disable event=<ref> 

event I ecb I e: This parameter specifies the 

the event which is to be disabled. If 
specified is already in a disable:! 
operation will take place. 

Examples disable el 



name of 
the event 
state no 
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3.12.8 DISPLAY I DI 



The DISPLAY command can be used to display the current 
status of a specified event. The result will be written on 
SCL^OUTPUT. The command format is as follows: 

display status=<ref> 

status I St This parameter specifies the name of the 
event whose status is to be displayed. 

Examplet ..display status el 
TYPE = EVENT 
CONDITION = CAUSED 
ACTION = DISABLED 
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3.13 MESSAGE SWITCHIN G 



3.13.1 SEND 



The purpose of this command is to send a message to 
another user or set of users. The command format is as 
fol lowsl 

send [to=<ident>] [unti l=<expr>3 [mail] 

to I tt This parameter specifies the name of the user 
or set of users to which the message Is to be 
sent. Omission of this parameter will cause the 
message to be sent to the operator. In this case 
if the Job sending the message is local batch or 
interactive the message will be sent to SYSTEMiOPt 
and if it is remote batch the message will be sent 
to REMOVE#OP. 

until I ui This parameter specifies a string containing 
an end of data delimiter.- Omission of this 
parameter will cause a default of ♦* to be 
assumed • 

main This parameter specifies that the message is to 
be mailed to the specified user or members of the 
set of users if they are not currently online. 

Examplel • • send to ras 

SUPPLY MESSAGE 
••RicK I have the library built now. 
..♦♦ 

MESSAGE SENT 
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3.13.2 MAIL 



The DUPDOse of this command is to mail a message to a 
user or set of users. The command format is as fol lowst 

mail tto=<ident>3 [un ti l=<expr >1 

to I ti This parameter specifies the name of the user 
or set of users to which the message is to be 
mailed. Omission of this parameter will cause the 
message to be mailed to the operator. In this 
case if the Job mailing the message is local batch 
or interactive the message will be mailed to 
SYSTEM#OP, and if it is remote batch the message 
will be mailed to REMOVE#OP. 

until I ut This parameter specifies a string containing 
an end of data delimiter. Omission of this 
parameter will cause a default of *♦ to ^be 
assumed. 

Example! ..mail to ras 

SUPPLY MESSAGE 
..Rick I have the library built now. 
..♦* 

MESSAGE MAILED 



3.13.3 DISPLAY I DI 



The DISPLAY command can be used to display the contents 
of the user's mailbox. The result will be written on 
SCLtfOUTPUT. The command format is as fol lowst 



display mai I 



mail I ml This parameter is a keyword parameter and is 
used to distinguish this variation of the DISPLAY 
command. 
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Example: SCL VER 1.0 2130 PM MONDAY JUNE 30, 1979 

PLEASE LOGIN 
. . login ras 

PROFILE PROCESSING INITIATED 

THERE IS MAIL IN YOUR MAILBOX 
..display mail 

FROM WJH 

Rick I have the library built now. 



3.13.^ PRINT I PR 



The PRINT command can be used to print the contents of 
the user's mailbox. The command format is as follows! 

print mai I 

mail I ml This parameter is a keyword parameter and is 
used to distinguish this variation of the PRINT 
command. 

Example! print mail 



3.13.5 DELETE I DEL 



The DELETE command can be used to delete tne contents 
of the user's mailbox. The command format is as follows! 

delete mail 

mail I ml This parameter is a keyword parameter and is 
used to distinguish this variation of the DELETE 
command. 

Example! delete mail 
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3.14 S CL CONTROL STRU CTURES 



3.14.1 RETURN 



The purpose of this command is to return control from 
the command file in which it appears. The command format is 
as f ol lows : 

return [user] 

user I ui This is a Keyword parameter, i.e. it does 
not require values, and is used to indicate that 
control is to be returned to the next command line 
in the standard input file. 

NOTEl The appearance of an end of file prior to a RETURN 
command will cause control to be returned as though a 
RETURN command had appeared as the last command in the 
command file. 

Examplet ..connect ioc#al ternate, job#display 
..define run, file=runfile 
..run (source, i isting) 

FORTRAN I=SCL#PARArt(l).LOW, 0=SCL#PARAM( 2) . LOW 
IF SCL#PARAM. COUNT EQ 2 
RETURN 



3.14.2 FOR / FOREND 



The purpose of these commands is to delimit a FOR 
looD. The loop format is as followsS 
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for index=<ref> range=<value I ist> 



forend 



index I ii This parameter specifies the name of the 
variable to be used as the index variable. 

range I ri This parameter specifies the values the 
index variable is to assume. When a range of 
values is quoted the assumed increment will be 1 
if the left hand side is less than the right hand 
side and -1 otherwise. 

Examplel for i (1..5, 10) 

submit input=array_of_f i les (i) 
forend 



3.14.3 IF / IFEND 



commands is to 
The conditional 



delimit 
command 



The purpose of these 
conditionally processed commands, 
format is as follows! 

if cond=<expr> 



ifend 

condition I cond I c: This parameter specifies a 
logical expression which will determine whether or 
not the commands between the IF and the IFEND are 
to be processed. If and only if the logical 
expression is true (non-zero) will they be 
processed. 

Examplel if (x eq y) 

display ( • X = y* ) 
go to labell 
ifend 
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3.1^.^ GOTO I GO 



The Durpose of this command is to transfer control to 
the command line containing the laoel specified. The 
command format is as follows: 



goto I abel =<ident> 



label I to I i: This parameter specifies tne name of 
the label to which control is to be transferred. 



Example* go to label 1 



3.1^. 


5 LABELI 




The oui 


block 


. A! 1 


block 


in w 


referenced fi 


label 


block 



BLOCK / LABELEND 



rpose of these commands is to delimit a label 
labels defined in SCL are local to the label 
hich their definition appears and can only be 
rom within that block. The general format of a 
is as f ol lows t 



labelb I ock 



I abelend 



NOTEI The maximum number of labels that can be defined in a 
label block is 16 and the maximum depth of label block 
nesting is 16. 
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3. 15 lJlSQ£l.l.iii£5US 



3.15.1 MICRO I MIC 



The purpose of this command is to define a micro. The 
command format is as followsi 

micro name=<ref> text=<expr> 

name I ni This parameter specifies the name of the 
micro to be defined. 

text I tt This parameter specifies the string of SCL 
text comprising the micro. 

Examplel ..micro k, text='»102^* 
..limit punch=5 k 



3.15.2 ACCEPT 



The purpose of this command is to read data from the 
standard input. The command format is as followsi 

accept value=<ref list> 

value I va I I v« This parameter specifies the names of 
one or more variables into which the data is to be 
read. 
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Example! ..collect fl 

SUPPLY RECORDS 
..accept {x,y,z) 
..execute main» param=Cxt y, z) 
..♦♦ 

■RECORDS COLLECTED 
..define cmd* file=fl 
. . cmd 

SUPPLY X 
..12, 3.^ 

SUPPLY Z 
..•This is a silly string' 



3.15.3 DISPLAY 



DI 



The DISPLAY command can be used to display a list of 
values. The result will be written on SCL#OUTPUT. The 
command format is as followss 

display value=<expr I ist> 

value I val I vi This parameter specifies one or more 
expressions whose values are to be displayed. 

Example! ..display (x ,y ,z ) 
12 
3. if 
This is a sil ly string 



3.15.^ SET 



The system allocates an array of 64 boolean elements 
called SCL#TOGGLE for each job Known to the system. Each 
element of the array is identified by an ordinal in the 
range 1..64. The initial setting of the SCL#TOGGLE array is 
a site parameter. The purpose of this command is to 

NCR/CDC PRIVATE REV 75/05/27 
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set/clear SCL toggles. The command format is as follows! 

set ton=<expr list>1 [off=<expr list>] 

on I oi This parameter specifies the toggles which are 
to be set on. 

off: This parameter specifies the toggles which are to 
be set off. 

Example! set on=(lf2) 

The following toggles have been assigned to the 
described functions! 

1 - This toggle controls the dialog mode of the SCL 
interpreter. When this toggle is on the 
interpreter will solicit missing required 
parameters from the user. Dialog mode is only 
meaningful for interactive jobs and therefore the 
toggle has no effect in a batch Job. 

ExampI e! . . set on 1 
..connect 

SUPPLY STREAM PARAMETER 
. .ioc#al ternate 

SUPPLY FILE PARAMETER 
• • job#display 



3.15.5 BASEFILE 



The purpose of this command is to appoint a file as the 
base file. The command format is as follows! 

basef i le file=<ref> 

file I fcb I f! This parameter specifies the name of 
the file being appointed* 



Example! basefile abc 
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3415.6 COPY 1 

2 

3 

The purpose of this command is to copy data. The k 

command format is as follows! 5 

6 
copy [from=<ref>] into=<ref> 7 

8 

from I fr I fJ This parameter specifies the name of the 9 

data source. Omission of this parameter will 10 

cause the base file to be used as the data 11 

source. 12 

13 

into I tot This parameter specifies the name of the 1^ 

data destination. Omission of this parameter will 15 

cause the base file to be used as the 16 

destination. 17 

18 

NOTEi The following table indicates the valid type 19 

combinations for the source and destination* 20 

21 
(to be suppi ied) 22 

23 
Example! copy from nl to n2 Zk 

25 
26 
27 
28 
29 
30 
31 
32 
33 
Zk 
35 
36 
37 
38 
39 

^1 
t*Z 
kZ 

kb 
^7 
^8 
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^.0 SYSI£M«E£P£BIQIB£ 1 

2 
3 

t* 

5 

6 
7 
The system repertoire is comprised of a set of commands 8 

which represent an ex ternal izat ion of the operating system 9 

requests available to a running program. These commands 10 
allow the user to invoke most of the operating system 11 
request processors directly. The command descriptions are 12 
contained in the various sections of the GDS at the points 13 
where the requests are defined. ik 

15 
16 
17 
18 
19 
20 
21 
22 
23 
Zk 
25 
26 
27 
28 
29 
30 
31 
32 
33 
3if 
35 
36 
37 
38 
39 
^0 
^1 

^^ 

^3 

k5 
<f6 
^7 
^8 



NCR/CDC PRIVATE REV 75/05/27 



5-1 
ADVANCED SYSTEMS LABORATORY CHP030if 

75/D5/27 
IPLOS GDS - SYSTEM COMMAND LANGUAGE 

5.0 OPERATOR REPERTOIRE 



5.0 OPERATOR REPERTOIRE 1 
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6. SAMPLE JOBS ^ 

2 
3 
^ 
5 
6 
JOB WJH " COBOL COMPILE AND EXECUTE " 7 

COLLECT SOURCE 8 

9 

. COBOL SOURCE DECK APPEARS HERE ±q 



♦♦ 



11 
12 

COBOL I=SOURCE, 0=OBJECT, L=LISTING 13 

SAVE OBJECT .^ 

PRINT LISTING ^5 

COLLECT DATA UNTIL • /♦' ^5 

. DATA DECK APPEARS HERE iq 

19 
/* 20 

OBJ AOD=OBJECT gl 

EXEC PROG=MAIN, PARAM=DATA 2? 

JOBEND II 

2k 
25 
26 
27 
28 
JOB WJH " COBOL EXECUTE ONLY " oq 

COLLECT DATA UNTIL '/♦• 30 

. DATA DECK APPEARS HERE 32 

33 

OBJ ADD=OBJECT 35 

EXEC PROG=MAIN, PARAM=DATA 3c 

JOBEND 3^ 

38 
39 
ffO 
^1 
^2 
t*3 
t*k 
k5 
kS 
k7 
^8 
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7.0 EXPRESSIONS 
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The valid SCL operators are as follows! 

■¥ • addition 

- • subtraction 

* multiplication 

/ ••••.•••. division 

'^* ..••.••• exponentiation 

CAT concatenation 

GT .....greater than 

GE •• greater than or equal to 

LT • less than 

LE less than or equal to 

EQ equal to 

NE not equal to 

AND and 

OR •..••••.•• or 

NOT not 
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7.2 OPERANDS 

When operations are performed in SCL expressions the 
operands are converted to type real or string depending upon 
the operator involved. 

The arithmetic operators <• » -» *» / and *♦ insist on 
numeric operands and yield a real result. The string 
operator CAT insists on string operands and yields a string 
result. The relational operators GT, GE» LT» L£» EQ and NE 
accept numeric or string operands but insist that both be of 
the same classt i.e. numeric or string. These operators 
yield an integer result of 1 or depending upon whether the 
relation is true or false respectively. The logical 
operators ANO» OR and NOT insist on numeric operands and 
yield an integer result of 1 or depending upon the truth 
value of the logical expression. Zero is considered false 
and non-zero is considered true by these operators. 

NUMERIC OPERANDS 

INTEGER 

REAL 

LNS SUBRANGE 

LNS INTEGER 

LNS REAL 

LNS BOOLEAN - TRUE = 1 and FALSE = 

LNS EVENT - CAUSED = 1 and CLEAR = 
STRING OPERANDS 

STRING 

LNS STRING 
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7.0 EXPRESSIONS 

7.3 ORDER OF EVALUATION 



7.3 OSPER OF EVALiJAIIOH 

Expressions are scanned from left to right. The 
following table reflects the precedence of the operators. 
The exponentiate operator has the highest precedence and the 
OR operator has the lowest precedence. 

f-* •.•...•..••• exponentiate 

* \ / •.•••...•...•. •••.• multiply I divide 

4- i - .......••..•. ..••• add I subtract 

CAT ....••.•••..... concatenate 

GT I GE I LT I LE I EQ I NE .. relationals 

NOT • not 

AND • ••«.. and 

OR or 

To override the normal order of evaluation the user 
must parenthesize the expression. 

expression •..••.... result 

3^3 6 

3-3 

3«3 9 

3/3 1 

3**3 ••• • 27 

3 GT 3 

3 GE 3 1 

3 LT 3 i'. 

3 LE 3 ••... 1 

3 Ed 3 ....• 1 

3 NE 3 

3 AND 3 1 

3 OR 3 1 

NOT 3 ,....• 

3-f3*3 12 

(3+3)»3 18 
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7.0 EXPRESSIONS 
7,1* FUNCTIONS 
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7.0 EXPRESSIONS 
7.^.2 DATE 



7.k FlJNCI-IflNS 



7.tt.l CLOCK 



The CLOCK function returns a string containing the 
clock time. The calling sequence is as follows: 

clockC format) 

format: This argument specifies the format in which the 
time is to be returned. The defined formats are 
as foil ows: 

AMPM: This specification will cause the time to be 
returned in hours and minutes am or pm (e«g« 
2:30 pm) • 

HM: This specification will cause the time to be 
returned in hours and minutes (e.g. 1^:30). 

HMSM: This specification will cause the time to be 
returned in hours* minutes* seconds and 
milliseconds (e.g. l^t 30 : 29.«»35) . 

Example: ..display 'Time now is • cat clock(ampm) 
Time now is 2:30 pm 



7.^.2 DATE 

The DATE function returns a string containing the 
date. The calling sequence is as follows: 

date(f ormat ) 

format: This argument specifies the format in which the 
date is to be returned. The defined formats are 
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as foil ows : 

MDY: This specification will cause the date to be 
returned as month day» year (e.g. June 30t 
1979). 

ISO: This specification will cause the date to be 
returned as year-month-day (e.g. 

1979-06-30). 

JULEAN: This specification will cause the date to 
be returned as YYDDD (e.g. 79181). 



Example: 



.display clock(ampm) cat 
2:30 pm June 30, 1979 



cat date(mdy) 



7.^.3 UNIQUE 

The UNIQUE function returns a string containing a 
unique identifier each time it is referenced. The calling 
sequence is as follows: 

unique(f ormat) 

format: This argument specifies whether a user 
identifier or system identifier is to be 
generated. USER will cause a user identifier to 
be generated and SYSTEM will cause a system 
identifier to be generated The format of the 
generated identifier will be as follows: 

U_XXX'XXX or S#XXXXXX 

where X will be in the set of digits or upper case letters. 

Example: strvar = unique(user) 
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7.0 EXPRESSIONS 
7.^.6 LOC 



7.k,U REF 



The REF function returns a reference name whose string 
representation is supplied as an argument to the function. 
This function allows the user to reference an object whose 
name is contained in a string variable* i.e.* indirect the 
reference. The calling sequence is as followsl 

ref(string> 

string! This argument specifies the string 

representation of the name being referenced. 

Example! create file = ref(strvar) 



7.^.5 SUBSTR 



The SUBSTR function returns a substring of jser defined 
length from a user supplied string. The calling sequence is 
as f ol I ows! 

substrCstringt start C» length]) 

stringi This argument specifies the string from which 
the substring is to be extracted. 

start: This argument specifies the starting point of 
the substring within the string - the 1st 
character being 1. 

length! This argument specifies the length of the 
substring being extracted. Omission of this 
argument will cause the remainder of the string to 
be extracted. 

Example! strvar = substr( •.. .substring. .. •♦^,9) 
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7.^.6 LOC 



The LOC function returns a pointer to the data area 
associated with the LNS name supplied as an argument. The 
calling sequence is as follows! 

I oc (name) 

name! This argument specifies the name whose data 
pointer is to be returned. 

Example! ptrvar = I oc (f 1 .owner ) 
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8.0 A$gIGNME[jJ, 



Values are assigned to LNS variables by use of the 
assignment statement. The general format of an assignment 
statement is as foilowst 



<ref > 



<expr> 



The following diagram shows the conversion rules 
applied to mixed mode assignment. The rows indicate the 
type of the variable on the left hand side of the equal sign 
and the columns indicate the type of the result of the 
expression on the right hand side. 



integer I real 



I integer 
I real 
I string 
I alias 
I other 



L 



_l^ 

I rule_l 
I rule_3 
I error 
I error 
I error 

_l 



_l_ 



string I other 



I rule_2 

I rule_l 

I error 

I error 

I error 



I error 
I error 
I rule3 
I ru I e_^ 
I error 
.l_. 



I error 
I error 
I error 
I error 
I ru I e_5 
J 



rule_l: The assignment is direct provided tie dimension 
of each side is equal. This rule will be relaxed 
in future versions. 

rule_2: The real value is truncated and the result is 
assigned according to rule_l. 

rule_3J The integer value is converted to real and the 
result is assigned according to rule_l. 

rule3t If the length of the string on the. left is 
greater than the length of the string on the right 
the string on the right is blank filled to the 
right. If the length of the string on the left is 
less than the length of the string on . the right 
the string on the right is truncated on the 
rijht. The result is then assigned according to 
ru I e_l. 
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rule_5t If the type of the left is equal to the type of 
the right assignment takes place according to 
rule_l. If they are of unlike type an error 
condition will result. 

Example: x(2) .y = 12.3^ 
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9.0 LAN(?UAG^ $YNTM 



The following syntax definition is designed for 
readability and does not represent a rigorous definition of 
the language. It is intended to give the reader sufficient 
information to be able to construct SCL text. 
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9.0 LANGUAGE SYNTAX 

9.1 CHARACTER SET 

2 
characters used for identifiers 3 

A...Z I a...z ••.... letters 5 

0...9 digits 6 

* ......•'.. number sign 7 

S ...•...•. dollar sign 8 

a .•••••• •••••• commercial at 9 

_ underline 10 

11 
characters used for integer constants 12 

13 

0...9 •••. digits Ih 

A...F t a...f •••... hex digits 15 

( .••.•••••••••••••. open parentheses 16 

) .••..••••.••.•••.. close parentheses 17 

18 
characters used for real constants 19 

20 

0...9 digits 21 

•••... decimal point 22 

E I e letter e 23 

^ • •'. p I us Zk 

- .••... minus 25 

26 
characters used for operators 27 

28 

+ ••••••• ••.••'. plus 29 

-... • minus 30 

* ....••..•••....•.. asterisk 31 
/ slant 32 

33 
characters used for qualification 3^^ 

35 
-> .•••••••••••••••• right arrow digraph 36 

•..••••••...••.•• period 37 

38 
characters used for punctuation 39 

^0 

\6 soace kl 

( •• open parentheses i*Z 

) close parentheses ^3 

9 .................. comma kk 

2. •...••.. .....a... colon 45 

* ...••.•• semicolon hS 

~ • equal sign k7 

k8 
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9.0 LANGUAGE SYNTAX 

9.1 CHARACTER SET 



string delimiter 



comment del imiter 



apostroDhe 



quotation mark 



NOTEJ All ascii characters not listed in the aboi/e character 
set have no defined meaning to the SCL interpreter. 
These characters may however be used as data characters 

by the user. 
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9.0 LANGUAGE SYNTAX 
9.2 FORMAL DESCRIPTION 



9.2 FQemL DESCRIPTION 

<inDut line> tt= <comm3nd I ine> I <data I ine> 

<command I ine> XJ= [<label>]... <command list> 

<label > 1 1= <ident> I 

<command I ist> 1 1= <command> c; <command >1 •• . 

<command> M= <command name> t < \i \ » > <param list> 1 
I <assignment.> 
I <query> 

<command name> t i= <ref> 

<param list> 1 1= <param>^ [ < Jft I , > C<param>l !••• 

<param> tt= <param name> 

I <param name> < l^ I = > <value list> 
I <value list> 

<param name> il= <ident> 

<value list> : := <value> I (<value> [^ <va lue >1 • ••) 

<value> 11= <expr> [<...> <expr>3.., 

<assignment> xx- <ref> = <expr> 

<query> Jl= <expr> 

<expr> M= <lterm> t tf OR K <lterm>l,.. 

<lterm> t:= <lfactor> [ k) AND b <l f actor>]. . . 

<l factor> i:= [NOT tf ] <lprimary> 

<lprimary> ::= <sterm> C J5 <relation> 15 <sterm>]... 

<relation> i J= GT I GE I LT I LE I EQ I NE 

<sterra> xx- <term> [ k$ CAT kS <term>l... 

<term> tt= C+ I -1 <factor> [<♦!-> <factor>l... 

<factor> tt= <primary> [<♦!/> <primary>] •• • 
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9.0 LANGUAGE SYNTAX 
9.2 FORMAL DESCRIPTION 



<primarv> i:= <operancl> [*♦ <operand> 3. . . 

<operand> JJ= <constant> 
I <ref> 
I <function> 
I (<expr>) 

<constant> Jl= <integer>r J <real> I <string> 

<lnteger> J t= <digit> C<hex digit>...l [(<base>)1 

<digit> IS= I 1 J 2 I 3 I 4 J 5 I 6 1 7 I 8 I 9 

<hGX digit> M= <digit> lAIBJCIDJEIF 
(aibtcidlelf 

<base> i:= <digit>... 

<real> Jt= <digit>... .<digit>... IE <♦ I - > <digit>...3 

<striny> ::= '[ascii character ].•• • 

<ref> i:= [<ident>->] <ident> t(<expr>)l [•<ident> 
C( <expr>) ] 3.. . 

<ref list> tt= (<ref> .[ ,<ref >3 . . .) 

<ident> ix= <alpha> C<alpha> I <digit>],., 

<alpha> tt- <letter> I # t $ t a I _ 

<letter> i:= A I Q \ C I D J E J F I G » H 
lltJiKiLtMiNiOiP 
JQIRJSITIUIVIWIX 
JYIZIalbJcJdIelf 
igihlii]IHIIImln 
loJplqlrlsJtlulv 
i w i X t y t z 

<ident list> i »= (<ident> C ,<ident > 1 . . . ) 

<function> it= <ident> [.<expr list>l 

<expr list> ::= (<expr> C ,<expr>] . . . ) 

<coniment> 1 1= "[ascii character]..." 

<data line> ::= Cascii character]... 

NCR/CDC PRIVATE REV 75/05/27 
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NOTEJ Spaces may be used freely between syntactic units to 
inprove readability and must be used where indicated. 
Whenever a space is allowedt multiple spaces may be 
specified. 
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10.0 COMMAND WRITERS GUIDE 

10.1 NAMING CONVENTIONS 



10.0 Q.0M11AMQ WRII£&a-£yia£. 



This section is intended to provide guidance for those 
who wish to produce new procedures In order to interface 
request macros to the external user? that is, to externalize 
a request. 

The actual production of a new command Interface 
procedure is a fairly simple task, and it is recognized that 
the provision of the command procedure is best performed by 
the person or persons providing the request macro. This 
implies that the documentation for the command procedure 
appears with and complements that of the request macro. 
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10.1 NAMING CONVENTIONS 



10.1.1 COMMAND PROCEDURE NAMING CONVENTION 

There is a consistent naming convention for command 
procedures, as follows. 

If one wishes to externalize the ATTACH request of the 
LNS section, then the command procedure name will bet 

SCL#LNS#ATTACH 

which means "The SCL (System Command Language) interface to 
the ATTACH request processor of the LNS (Logical Name Space) 
section". This naming convention should be followed 
throughout. 

The PDT (Parameter Description Table) must be declared 
within the command procedure with the XOCL attribute and 
must be given the name of the procedure suffixed by _PDT. 

SCL#LNS#ATTACH_PDT 



10.1.2 PARAMETER KEYWORD NAMING CONVENTION 



A convention for parameter names, synonyms and 
abbreviations has been empirically established. The rules 
for choosing these names are fairly simplel 

o Use the parameter name in full. 

o Choose as many synonyms and abbreviations as 
thought necessary. Any abbreviations chosen 
should have mnemonic significance, or be easily 
recognized because of widespread prior usage, and 
should preferably be easily pronounced. If 
possible, try to satisfy all these conditions. 
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10.0 COMMAND WRITERS GUIDE 

10.1.2 PARAMETER KEYWORD NAMING CONVENTION 



ADVANCED SYSTEMS LABORATORY 

IPLOS GDS - SYSTEM COMMAND LANGUAGE 



CHP030^ 



10-^ 
75/05/27 



10.0 COMMAND WRITERS GUIDE 

10.2 FORMAT AND LAYOUT OF DOCUMENTATION 



o The final synonym is the initial letter of the 

parameter. It is recognized that this can in 
certain circumstances lead to conflict. When this 
occurs* use the initial letters of the parameters 
in order of ocurrence until conflict. 

An example of the LNS#DECLARE command wilt illustrate 
these points. 

SEG ENT 

LNS#DECLARE [SEGMENT=<IDENT>] ENTRY=<IDENT> 
S E 

LEN DIM 

[TYPE=<IDENT>J [ LENGTH=<EXPR>1 rDIMENSION = <E XPR>1 
T L D 

[STATUS=<NAME>3 

Note that in this example* there would be a clash 
between the "S" in "SEGMENT" and "STATUS". Since "STATUS" 
is not the first ocurrence of a parameter beginning with "S" 
in the command, the "S" initial is used for ••SEGMENT". 

A list of parameter namesi synonyms and abbreviations 
are attached at the end of this section. This is for 
guideline purposes only and no attempt will be made to Keep 
this up to date with future enhancements. 
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LAYOUT 

When a Request Processor Macro Call Format is 
documented, the corresponding Command Format will be 
documented along with it. 

The necessary documentation includes I 

o The macro name. 

o A short explanatory text, which briefly describes 
the function. 

o A model reference to the request macro. 

o Explanations of each Parameter. This should also 
include the manner in which null parameters are to 
be conveyed to the request processor, and the 
effect of the null parameter on the request. 

o The syntax of the System Repertoire Command. 

o Explanations of each parameter. The alternative 
keywords for the parameters should be given at 
this point. 



10.2.1 EXAMPLE OF DOCUMENTATION LAYOUT 



LNS#DECLARE 

The purpose of the LNS#DECLARE request is to declare an 
entry in the LNS. The macro format is as follows. 



LNS#DECLARE ( SEGMENT, ENTRY, TYPE, LENGTH, DIM, LOCATOR, STATUS I 

SEGMENT I The segment parameter specifies a string 
containing the name of the segment in which the 
entry is to be declared. Omission of the segment 
parameter ( indicated by a blank string ) will 
cause the entry to be declared in the most local 
segment. 
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10.0 COMMAND WRITERS GUIDE 

10.2.1 EXAMPLE OF DOCUMENTATION LAYOUT 



ENTRY : The entry parameter specifies a string 
containing the name of the entry being declared. 

TYPE s The type parameter specifies a string containing 
the type of the entry being declared. Omission of 
the type parameter ( indicated by a blank string ) 
will cause an entry of type INTEGER to be 
declared. The valid LNS types are those described 
under "data types" or any complex type previously 
defined by LNS#RECORD and LNS#FIELO. 

LENGTH t The length parameter is only meaningful when 
declaring string variables. In this case the 
length parameter specifies an integer containing 
the number of bytes to be allocated for the 
string. Omission of the length parameter ( 
indicated by a ) will cause a default of 32 to 
be assumed. 

DIM I The dim parameter specifies an integer containing 
the dimension of the entry being declared. 
Omission of the dim parameter ( indicated by a ) 
will cause a default of 1 to be assumed. 

LOCATOR : The locator parameter specifies a pointer 
variable into which the system will place a 
pointer to the LNS internal descriptor for the 
entry. If the user specifies the same pointer on 
subsequent requests for the entry a search will be 
el iminated. 

STATUS t The status parameter specifies a variable into 
which the status record is to be placed. The 
status codes returned are described under "error 
conditions". 

The System Repertoire Command Format is as fol lows. 



LNS#DECLARE t SEGMENT=<IDENT >1 ENTRY=<IOENT> [T YP£=< IDENT> 1 

tLENGTH=<EXPR>3 [DIMENSI0N=<EXPR>1 C STATUS=<REFNAME>1 

SEGMENT J SEG I S t This parameter specifies the name 
of the LNS siegment in which the entry is to be 
declared. Omission of the segment parameter will 
cause the entry to be declared in the most local 
segment. 

NCR/CDC PRIVATE REV 75/05/27 
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ENTRY I E : This parameter specifies the name of the 
entry to be declared. 

TYPE I T I This parameter specifies the type of the 
entry to be declared. Omission of the type 
parameter will cause the entry to be declared as 
type integer. 

LENGTH I LEN I L I This parameter is only meaningful 
when declaring string variables. In this case it 
specifies the number of bytes to be allocated for 
the string. Omission of the length parameter will 
cause a default of 32 to be assumed. 

DIMENSION I DIM I D t This parameter specifies the 
number of occurrences of the entry to be 
declared. Omission of the dimension parameter 
will cause a default of 1 to be assumed. 

STATUS : This parameter specifies a variable into which 
the status is to be returned. Omission of this 
parameter will cause the SCL error handler to be 
invoked upon the occurrence of an error 
condition. 
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DMMAND PROCEDURE 



It is desirable that the layout and coding of command 
procedures should retain a degree of consistency throughout 
the system. This will ensure that maintenance of coding 
will be somewhat eased* since a consistent layout will maKe 
familiarization easier f^or the maintenance programmer. 

Instead of attempting to give 'verbal" descriptions of 
the manner in which Command Procedures should be laid out 
and the declarations necessaryt an example of a typical 
Command Procedure is attached at the end of the section. 
Hopefully this example will be followed reasonably closely 
in style for the reasons mentioned above. 
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10.^ COMMAND. PROCEDURE INTERFACE 





1 INPUT 1 
1 t 












1 COMMAND 1 
1 LIST 1 
1 SCANNER 1 






1 






1 COMMAND 1 . 




1 1 PROCEDURE 1 1 
1 i 11 


1 PARAMETER 1 
1 DESCRIPTION 1 
1 TABLE 1 
1 1 


1 

1 
1 


1 PARAMETER 1 
1 VALUE 1 
1 TABLE 1 
1 1 


1 1 PARAMETER 1 1 
1 1 LIST 1 1 




1 SCANNER 1 
1 1 





Fig 10-1 
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10.5 LIST OF KgYWORPS ANQ SYNONYM? TQ QATE 

ADD 

ADDRESS - ADDR 

ATTRIBUTE - ATTR 

BLOCK - BLK 
BUFFER - BUF 

CATALOG - CATLG 

CHAIN 

CLOCK 

COBOL - COB 

CONDITION - COND 

COPIES 

DELETE - DEL 
DESCRIPTOR - OESC 
DIMENSION - DIM 

EDITION - ED 
ENTRY - ENT 

FIELD 

FILE - FCB 

FORM 

FORTRAN - FORT, FTN 

FROM - FR 

GENERATION - GEN 

INCREMENT - INCR 
INITIALIZE - INIT 
INPUT - INP 
INTO - TO 
ITEM 

KEY 

LABEL 

LENGTH - LEN 
LISTING - LIST 

MAIL 

NAME 

OBJECT - OBJ 
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OUTPUT - OUT 

PARAMETER - PARAM 
POSITION - POSN 
PRINT - PR 
PROCEDURE - PROC 
PROGRAM - PROG, PCB 
PUNCH - PU 



QUALIFIER 

RECORD - REC 
REJECT - REJ 
RESOURCE 



QUAL 



SEG 



SEGMENT 

SITE 

STATUS 

STREAM 

SWL 

TASK - TCB 

TERMINAL 

TIME 

TRACK - TRK 

TRAP 

TYPE 



UCB 



UNIT 
UNITSET 
UNTIL 

USAGE - USE 
USER 



VALUE - VAL 
VOLIO - VID 
VOLSET - VCB 

WORD - WRD 
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11.1 DATA STRUCTURES 



11.0 A PPE 



SCL'SCANNERS 



The information in this appendix is internal 
maintainance level documentation and is included in this 
document to assist those responsiole for writing command 
procedures in support of the system repertoire. The data 
structures defined are subject to change at the field level) 
however* the different of data structures defined will in 
all probability be those found in the final BIS. 
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11.1.1 SCL STRING - SCL#STRING 



The definition of SCL#STRING is as followsl 

TYPE 

SCL#STRING = RECORD 

LHIl 1..256, " left hand index " 

RHIt 0..255, " right hand index " 

BUFJ STRING (255) OF CHAR, " character buffer " 

recend; - 

LHIJ This field contains the position of the 1st 
character of the string within the buffer. The 
position of the 1st character of the buffer is 1 
and therefore if the string is left justified in 
the buffer LHI=1. 

RHIl This field contains the position of the last 
character of the string within the buffer. The 
length of a string is defined to be RHI-LHI+1. 

BUFt This field contains the characters comprising the 
string. 



11.1.2 SCL SYMBOL - SCL#SYMBOL 

rhe definition of SCL#SYMBOL is as follows: 

TYPE 

SCLffSYMBOL = RECORD 

TYPt INTEGER, " type code " 

SVX SCL#STRING, " string value " 

recend; 

TYPi This field contains the encoded type of the 
NCR/CDC PRIVATE REV 75/05/27 
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11.1.4 TYPE SCL#PDT = RECORD 



symbol. 

SVl This field contains the string representation of 
the symbol . 



11.1.3 SCL TOKEN - SCL#TOKEN 



The definition of SCL^TOKEN is as follows! 

TYPE 

SCL/^TOKEN = RECORD 

TYPI INTEGER, '" tyoe code " 

OESC: LNS#DESC, " LNS descriptor " 

IV t INTEGER, •• integer value " 

RVI REAL, " real value " 

SVl SCL#STRING, " string value " 
RECENO; 

TYPt This field contains the encoded type of the 
token. 

OESCt This field contains the LNS descriptor of the 
name when the token is of type name. 

IVt This field contains the numeric value when the 
token is of type integer. 

RVJ This field contains the numeric value when the 
token is of type real. 

SVJ This field contains the string value when the token 
is of type string. When the token is of type name 
this field contains the string representation of 
the naue and when the token is of type foreign 
this field contains the string representation of 
the foreign text. 
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11.1.4 TYPE 



SCLaP3T = RECORD 



CMDJ STRING(31) OF CHAR, " command name " 
REQ: SET OF 1..64, " set of required parameters " 
FGNJ SET OF 1..64, " set of foreign text parameters 
RNGi SET OF 1..64, " set of range parameters " 
MINI ARRAYC1..64] OF INTEGER, " minimum # of values 
MAXt ARRAYtl..64] OF INTEGER, " maximum # of values 
PIDt ARRAYC1..64] OP " parameter identifiers" 
RECORD 

NAMEl STRING(31) OF CHAR, " parameter name 
POSNl INTEGER, " parameter position " 



recend; 



RECEND, 



REQi This field contains the set of required 

parameters. If a parameter appears in this set 

and is not supplied by the user in the parameter 
list an error condition will result. 

FGNt This field contains the set of foreign text 
parameters. The values for these parameters will 
be returned in LOV as type foreign and the SV 
field will contain the text specified. 

RNGI This field contains the set of parameters which 
allow ranges as values. If a range is supplied by 
the user for a parameter which does not appear in 
this set an error condition will result. 

MIN« This field contains the minimum number of values 
allowed for each parameter. The field only 
applies when the parameter is supplied by the user 
in the parameter list. It is reasonable, 
therefore, to specify a PDT where a given 
parameter does not appear in the REQ set but whose 
minimum number of values is greater than 0. In 
this case the parameter is optional, but if 
supplied must contain at least the stated number 
of values* 

MAXt This field contains the maximum number of values 
allowed for each parameter. This field only 
applies when the parameter is supplied by the user 
in the parameter list. 

PIDl This field contains the names and positions of the 
parameters. Every parameter supplied by the user 



1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 



NCR/CDC PRIVATE REV 75/05/27 



NCR/CDC PRIVATE REV 75/0 5/27 



ADVANCED SYSTEMS LABORATORY 

IPLOS GDS - SYSTEM COMMAND LANGUAGE 



CHP030tf 



11-5 
75/05/27 



11,0 APPENDIX A .•. SCL SCANNERS 
11.1. it TYPE SCL#PDT = RECORD 



ADVANCED SYSTEMS LABORATORY 

IPLOS GDS - SYSTEM COMMAND LANGUAGE 



CHP030^ 



11.0 APPENDIX A ... SCL SCANNERS 
11.1.6 OS STATUS - OS#STATUS 



11-6 
75/05/27 



must be defined in the PID to achieve normal 
completion. If the parameter is specified by name 
its name must appear in the PID» and it the 
parameter is specified positionally its position 
must appear in the PID. 



11.1.5 SCL PARAMETER VALUE TABLE - SCL#PVT 



The definition of SCL#PVT is as followsl 

TYPE 

SCL#PVT = RECORD 

DEFP: SET OF 1..6^, " set of defined paramesters " 

DEFNi SET OF 1..6't, " set of defined parameter names " 

CNT: ARRAYCL.IO] OF INTEGER, " # of values / parameter " 

LOVJ ARRAYC1..6^,1..5] OF SCLi^TOKEN, " low values " 

HIVJ ARRAYC1..6^,1..5] OF SCL#TOKEN, " high values " 

recend; 

DEFP: This field contains the set of quoted 
parameters. The number of each parameter supplied 
by the user in the parameter list will be 
contained in the DEFP set upon normal completion. 

DEFNt This field contains the set of names quoted in 
the list. 

CNTJ This field contains the number of values quoted 
for the parameter. 

LOV» This field contains the low values quoted in the 
list. 

HIVJ This field contains the high values qjoted in the 
list. When a range is not quoted the low value 
and high value are equal ••• LOVCP#yV#] = 

HIV[P#,V#]. 
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11.1.6 OS STATUS - OS#STATUS 



The definition of OS#STATUS is as followsl 

TYPE 

OS#STATUS = RECORD 

LEVELi O..OFF(16), "general level indicator" 
FROMI STRING(2) OF CHAR, " issuing os section " 
ST.CODEI O..OFFFF(16) , " specific status code " 
MESGl STRING (32) OF CHAR, " message mask " 

RECEND? 

LEVELI This field contains the general status, the 
values of which are shown in the IPLOS structure 
overview document. 

FROMI This field contains the operating system section 
that issued the status. 

ST_CODEt This field contains the specific status code 
issued. 

MESGl This field contains the message mask to be used 
by the system message generator when constructing 
diagnostic messages. 
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11.2.2 SCAN TOKEN - SCL#GET_TOKEN 



11.2 PE 



11.2.1 SCAN SYMBOL - SCU#GET_SYMBOL 



The purpose of this procedure is to scan the source and 
return the next symbol. The calling sequence is as follows! 

SCL#GET_SYMBOL (source .symbol , status) 

source: This parameter specifies the string of text to 
be scanned. As the text is scanned the left hand 
index of the string is updated to -^eflect the 
current scan position. 

symbol I This parameter specifies the name of a variable 
into which the symbol is to be returned. The 
symbol types returned are as follows! 

type_space ......... string of spaces 

type_an ••.•........ string of alphanumeric characters 

type_digit ••••...•• string of digits 

type_foreign «. foreign character 

type_end •• end of text 

status* This parameter specifies the name of a variable 
into which the status is to be returned. 



11.2.2 SCAN TOKEN - SCL#GET_TOKEN 



The purpose of this procedure is to scan the input and 
return the next toKen. If the toKen stacK ( SCL#TOKEN_STACK) 
is not eoipty the token at the top of the stacK will be 
removed and returned to the caller. If the token stack is 
empty the source will be scanned for the next token. Names 
are looked up in the LNS» numbers are converted to their 
internal representation and mnemonic operators are 
classified by this procedure. The calling sequence is as 
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fol lows: 

SCL#GET_TOKEN( source, token, status) 

source: This parameter specifies the string of text to 
be scanned. As the text is scanned the left hand 
index of the string is updated to reflect the 
current scan position. 

token: This parameter specifies the name of a variable 
into which the token is to be returned. The token 
types returned are as follows: 

type_unknown •••..•. unknown value 

type_name • name 

type_integer .•.../• integer value 

type_real .•••• real value 

type_string ..••••J. string value 
type_add .•...••.... •>■ 

type_sub •«. - 

type_mult • ♦ 

type.div ........... / 

type_exp •••..?• ♦♦ 

type_cat '. CAT operator 

type_gt GT operator 

type_ge GE operator 

type_lt • ••••«. LT operator 

type.le ••••• •. LE operator 

type_eq ...•• ,, EQ operator 

type_ne ••••• «. NE operator 

type__and ..••... .... AND operator 

type_or ••.. OR operator 

type_not .•••••...•. NOT operator 

type_assign ..•••••. = 

type_open .••.•...«. ( 
type__close •••••••.. ) 

type_comma ••.•••..., 

type_period ..« 

type_el I ipsis •••••••. 

type_colon .••••.... : 

type_semicol on ••••. ; 

type_foreign ...•.•. foreign text 
type_end .....••..,. end of text 

status: This parameter specifies the name of a variable 
into which the status is to be returned. 
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11.2.3 SCAN REFERENCE NAME - SCL#REF 

The purpose of this procedure is to scan the string 
representation of a name and return its LNS descriptor. The 
calling sequence is as foMowst 

SCL//REF{sv,desc, status) 

svJ This parameter specifies the string to be 
converted. 

desct This parameter specifies the name of a variable 
into which the LNS descriptor is to be returned. 

status: This parameter specifies the name of a variable 
into which the status is to be returned. 



11.2.^ STACK TOKEN - SCL#STACK_TOKEN 

The purpose of this procedure is to stacK a toKen for 
later retrieval by SCL#GET_TOKEN. The catling sequence is 
as foil ows t 

SCL#STACK_TOKEN( token, status) 

token: This parameter specifies the token to be 
stacked. 

status: This parameter specifies the name of a variable 
into which the status is to be returned. 



11.2.5 SCAN AND EVALUATE EXPRESSION - SCL#EXPR 



The purpose of this procedure is to scan and evaluate 
an expression. If the expression is composed of a single 
name the token returned will contain the LNS descriptor for 
the name but the value described will not be returned. This 
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is done to allow call by reference in parameter lists. If 
the expression is composed of operands and operators it will 
be evaluated and the token returned will describe the 
resultant value. The calling sequence is as folfowss 

SCL #EXPR( sour cet token ^status) 

source: This parameter specifies the string of text to 
be scanned. As the text is scanned the left hand 
index of the string is updated to reflect the 
current scan position. 

token: This parameter specifies the name of a variable 
into which the token is to be returned. The token 
types returned are as follows: 

type_name •••••••.•. name 

type_integer ..••... integer value 
type_real ••.•••.•.^. real value 
type_string ••.•.... string value 

type_foreign .•••... foreign text 

status: This parameter specifies the name of a variable 
into which the status is to be returned. 



11.2.6 SCAN PARAMETER LIST - SCL#PLIST 
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SC L#PL 1ST (sour ce,pdt,pvt, status) 
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sourcet This parameter specifies the string of text to 1 
be scanned. As the text is scanned the left hand 2 
index of the string is updated to reflect the 3 
current scan position. ^f 

5 

pdtt This parameter specifies a parameter description 6 

table. 7 

8 

pvti This parameter specifies the name of a variable 9 

into which the parameter value table is to be 10 

returned. 11 

12 

statust This parame^ter specifies the name of a variable 13 

into which the status is to be returned. 1^ 

15 
16 
17 
18 
19 
11.2.7 SCAN COMMAND LIST - SCL#CLIST 20 

21 

^ 22 

The purpose of this procedure is to scan and interpret 23 

a command list. The calling sequence is as followsl Zk 

25 
SCL#CLIST{source, status) 26 

27 

sourcet This parameter specifies the string of text to 28 

be scanned. As the text is scanned the left hand 29 

index of the string is updated to reflect the 30 

current scan position. 31 

32 

statust This parameter specifies the name of a variable 33 

into which the status is to be returned. 3^ 
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12.0 APPENQIX 9 



i.-iimJ^£BSIflN PRO££IiyR£S 



The information in this appendix is internal 
maintainance level documentation and is included in this 
document to assist those responsible for writing command 
procedures in support of the system repertoire. The data 
structures defined are subject to change at the field level* 
however* the different of data structures defined will in 
ail probability be those found in the final BTS« 
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12.1.1 SCL STRING - SCL^STRING 



The definition of SCL#STRING is as followsl 

TYPE 

SCL^STRING = RECORD 

LHIt 1..256, " left hand index " 

RHIt 0..255, '• right hand index " 

BUFt STRING(255) OF CHAR, " character buffer " 

recend; 

LHIt This field contains the position of the 1st 
character of the string within the buffer. The 
position of the 1st character of the buffer is 1 
and therefore if the string is left justified in 
the buffer LHI=1. 

RHIi This field contains the position of the last 
character of the string within the buffer. The 
length of a string is defined to be RHI-LHI+1. 

BUFt This field contains the characters comprising the 
string. 



12.1.2 SCL TOKEN - SCL#TOKEN 



The definition of SCL#TOKEN is as followst 
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TYPE 

SCL/>TOKEN = RECORD 

TYPt INTEGER, " type code " 

DESCJ LNS//DESC, " LNS descriotor " 

IV: INTEGER, " integer value " 

RVt REAL, " real value " 

SVi SCL#STRING, " string value " 

recend; 

TYPI This field contains the encoded type of the 
token. 

3ESC: This field contains the LNS descriptor of the 
name when the token is of type name. 

IVi This field contains the numeric value when the 
token is of type integer. 

RVi This field contains the numeric value when the 
token is of type real. 

3VJ This field contains the string value when the token 
is of type string. When the token is of type name 
this field contains the string representation of 
the name and when the token is of type foreign 
this field contains the string representation of 
the foreign text. 



12.1.3 OS STATUS - OS#STATUS 



The definition of OS#STATUS Is as follows* 

TYPE 

OS#STATUS = RECORD 

level: 0..0FF(16), " general level indicator " 
from: string (2) of char, " issuing os section " 
ST_C0DE: 0.. 0FFFF(16) , " specific status code " 
MESG: STRING,(32) of char, " message mask " 

recend; 

level: This field contains the general status, the 
values of which are shown in the IPLOS structure 
overview document. 
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from: This field contains the operating system section 
that issued the status. 

ST_C0DE: This field contains the specific status code 
issued. 

MESG: This field contains the message mask to be used 
by the system message generator when constructing 
diagnostic messages. 
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12.2 PROCEDURES 



12.2.1 CONVERT STRING TO INTEGER - SCL#SV_IV 



The purpose of this procedure is to convert a string 
containing the character representation of an integer to its 
internal representation. The catling sequence is as 
foi iowss 

SCL#SV_IV{sv,iv,status) 

svJ This parameter specifies the string to be 
converted. 

ivt This parameter specifies the name of a variable 
into which the integer value is to be returned. 

status! This parameter specifies the name of a variable 
into which the status is to be returned. 



12.2.2 CONVERT INTEGER TO STRING - SCL#IV_SV 

The purpose of this procedure is to convert the 

internal representation of an integer value to its character 

string representation with the base specified. The calling 
sequence is as followss 

SCL#IV_SV(iv,base,sv) 

ivt This parameter specifies the integer value to be 
converted. 

base: This parameter specifies an integer in the range 
2.. 16 denoting the base of the desired 
representation. 

svJ This parameter specifies the name of a variable 

NCR/CDC PRIVATE REV 75/05/27 
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into which the string is to be returned. 



12.2.3 CONVERT STRING TO REAL - SCL#SV„RV 



The purpose of this procedure is to convert a string 
containing the character representation of a real number to 
its internal representation. The calling sequence is as 
foi lowst 

SCL#SV_RV(sv,rVfStatus) 

svt This parameter specifies the string to be 
converted. 

rvt This parameter specifies the name of a variable 
into which the real value is to be returned. 

status* This parameter specifies the name of a variable 
into which the status is to be returned. 



12.2.^ CONVERT REAL TO STRING - SCL<^RV_SV 



The purpose of this procedure is to convert the 
internal representation of a real value to its character 
string representation. The calling sequence is as foi lowst 

SCL#RV_SV(rv,sv) 

rvt This paramete^r specifies the real value to be 
converted. 

svt This parameter specifies the name of a variable 
into which the string is to be returned. 
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12.2.5 CONVERT FIXED STRING TO SCL STRING - SCL#FS_SV 



The Duroose of this procedure is to convert a fixed 
string to a string. Trailing blanks are truncated during 
the conversion. The calling sequence is as foflowsx 

SCL#FS_SV(fs,sv) 

fst This parameter specifies the fixed string to be 
converted. 

svt This parameter specifies the name af a variable 
into which the string is to be returned. 



12.2.6 CONVERT TOKEN TO INTEGER - SCL#TOK_IV 



The purpose of thfs procedure is to convert a token to 
an integer value. If the token represents an integer 
constant the procedure simply returns the value contained in 
the IV field of the token. If the token represents a real 
constant the value contained in the RV field of the token is 
truncated and returned. If the token represents an LNS 
integer variable the value is obtained from the LNS and 
returned. If the token represents an LNS real variable the 
value is obtained from the LNS, truncated and then 
returned. Anything else will give rise to an error 
condition. The calling sequence is as followss 



SCL#TOK_IV{tok,iv, status) 

tok: This parameter 
converted. 



specifies the token to be 



ivi This parameter specifies the name of a variable 
into which the? integer value is to be returned. 

statusJ This parameter specifies the name of a variable 
into which the status is to be returned. 
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12.2.7 CONVERT TOKEN TO REAL - SCL#TOK_RV 
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The purpose of this procedure is to 
a real value. If the token represents 
the value contained in the IV field of 
converted to real and returned. If th 
real constant the procedure simply 
contained in the RV field of the 
represents an LNS integer variable 
obtained from the LNS, converted t o re 
the token represents an LNS real variab 
obtained from the LNS and returned. Any 
rise to an error condition. The calli 
fol I ows: 

SCL#TO K_RV( tok, rv, status) 

tok: This parameter specifies the token to be 
converted. 

rvt This parameter specifies the name of a variable 
into which the real value is to be returned. 

status: This parameter specifies the name of a variable 
into which the status is to be returned. 



12.2.8 CONVERT TOKEN TO STRING - SCL#TOK_SV 



The purpose of this procedure is to convert a token to 
a string. If the token represents a string constant the 
procedure simply returns the value contained in the SV field 
of the token. If the token represents an LNS string 
variable the value will be obtained from the LNS converted 
to varying (with truncation of trailing blanks) and 
returned. Anything, else will give rise to an error 
condition. The calling sequence is as follows! 

SCL^TO K_SV(t ok, SV, status) 

tok: This parameter specifies the token to be 
converted. 
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svJ This parameter specifies the name of a variable 
into which the! string Is to be returned. 

statusi This parameter specifies the name of a variable 
into which the status is to be returned. 



12.2.9 CONVERT TOKEN TO TYPE DESCRIPTION - SCL#TOK_TYPE 



The purpose of this procedure is to construct a string 
of text describing the token which was passed to the 
procedure. This string is commonly placed in the parameter 
the status record for subsequent message 
The calling sequence is as followst 



field of 
generat ion. 



SCL#TOK_TYPE(tok, fs) 



tokt This parameter specifies the token to be 
described. The description strings generated for 
the various token types are as fol lows! 

type_unknown ....... "unknown value" 

type_name ••.......• "LNS type" 

type__integer ....... "integer value" 

type_real ..••••••.. "real value" 

type_string ......•;. "string value" 

type_add .^. "+" 

type_sub ........... "-" 

type^mult "♦" 

type.div ...^. "/" 

type_exp ••••..«../. ••♦♦" 

type_cat ..••.• "CAT operator" 

type_gt •..•.«....•• "GT operator" 
type_ge •......••.•. "GE operator 

type_lt "LT operator 

type_le ..•......••. "LE operator 

type_eq "EQ operator 

type_ne ......•..••. "NE operator 

type_and .•.•.•••••^. "AND operator 

t ype_or "OR operator 

type_not ........... "NOT operator 

type_assign "=" 

type_open ......... . "(" 

type_close .'. ">" 
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type_comma .••••••.. 

type_period 

type^e I I ipsis 

type_colon 

t ype.semico i on •••.. 
type_foreign ....... 

type_end .•••••..... 



foreign text" 
end of text" 



fst This parameter specifies the name of a fixed string 
variable into which the description is to be 
returned. 



12.2.10 OUTPUT A VALUE - SCL#PUT_VAL 



The purpose of this procedure is to output a value. 
The calling sequence is as follows! 

SCL#PUT_VAL(stream,tok,status) 

streaml This parameter specifies the IOC stream to 
which the value is to output. 

toki This parameter specifies the token whose value is 
to be output. 

status: This parameter specifies the name of a variable 
into which the status is to be returned. 
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13.0 APPEND IX C . 



The information in this appendix is internal 
maintainance level documentation and is included in this 
document to assist those responsible for writing command 
procedures in supoort of the system repertoire. The data 
structures defined are subject to change at the field level » 
however, the different of data structures defined wi If in 
all probability be those found in the final BTS. 

The procedures described in this appendix define an 

input/output interface which allows users to logically 

concatenate input from multiple sources and distribute 
output to multiple destinations. 

During Job initiation the standard input file 
(JOB#INPUT) is opened and placed at the bottom of the input 
control stack. The standard print file (J08#PRINT) is 
al located and connected to the standard output and 
diagnostic streams. 
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Knowledge of the following data structures is required 
to interface with IOC. 



13.1.1 SCL STRING - SCL#STRING 



The definition of SCL^fSTRING is as followsl 

TYPE 

SCL#STRING = RECORD 

LHIX 1..256, " left hand index " 

RHIl 0..255, •• right hand index " 

BUFI STRING (255) OF CHAR, " character buffer " 

recend; 

LHIl This field contains the position of the 1st 
character of the string within the buffer. The 
position of the 1st character of the buffer is 1 
and therefore if the string is left Justified in 
the buffer LHI=1. 

RHIf This field contains the position of the last 
character of the string within the buffer. The 
length of a string is defined to be RHI-LHI+1. 

BUFt This field contains the characters coraDrising the 
string. 



13.1.2 INPUT control STACK - IOC#INPUT 

The definition of lOC^INPUT is as followsl 



1 
2 
3 
k 
5 
6 
7 
8 
9 
10 
11 
12 
13 
1^ 
15 
16 
17 
18 
19 
20 
21 
22 
23 
2k 
25 
26 
27 
28 
29 
30 
31 
32 
33 
3^ 
35 
36 
37 
38 
39 
kQ 
kl 
kZ 
k3 
kk 
kS 
kb 
k7 
kQ 



NCR/CDC PRIVATE REV 75/05/27 



NCR/CDC PRIVATE REV 75/05/27 



ADVANCED SYSTEMS LABORATORY 

IPL05 GDS - SYSTEM COMMAND LANGUAGE 



CHPOSO'f 



13-3 
75/05/27 



13,0 APPENDIX C ••. INPUT/OUTPJT CONTROL (IOC) 
13,1.2 INPUT CONTROL STACK - lOC^INPUT 



ADVANCED SYSTEMS LABORATORY 

IPLOS GDS - SYSTEM COMMAND LANGUAGE 



CHP030^ 



13.0 APPENDIX C ... INPUT/OUTPUT CONTROL (IOC) 
13.1.3 IOC STREAM CONNECTION TABLE - IOC#STREAM 



13-^ 
75/05/27 



I0C<^INPUT: tXDCL] 
RECORD 

TOPI INTEGER, " TOP OF STACK " 
FRAMEJ ARRAY £1..*] OF 
RECORD 

FCBI LNS#OESC, " FCB DESCRIPTOR " 
ODI DM#OD, " OPEN DESCRIPTOR " 
POSJ INTEGER, " RELATIVE POSITION 
RECEND, 

recend; 



13.1.3 IOC STREAM CONNECTION TABLE - lOCfSTREAM 



The definition of IOC#STREAM is as follows! 

IOC#STREAMJ [XDCLl 
RECORD 

DEF: ARRAY CI. .6^] OF BOOLEAN, " DEFINITION MAP " 
CONJ ARRAY CI.. 6^, 1..163 OF BOOLEAN, " CONNECTION MAP " 
LISTI ARRAY CI. .161 OF 
RECORD 

FCBt LNS#OESC , " FCB DESCRIPTOR " 
ODI DM#OD, " OPEN DESCRIPTOR " 
COUNT t 0..6t», " CONNECTION COUNT " 
RECEND, 

recend; 
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CONi This field contains a boolean map representing the 
NCR/CDC PRIVATE REV 75/0 5/27 



1 
2 
3 

5 
6 
7 
6 
9 
10 
11 
12 
13 
Ik 
15 
16 
17 
18 
19 
20 
21 
22 
23 
2k 
25 
26 
27 
28 
29 
30 
31 
32 
33 
3i» 
35 
36 
37 
38 
39 
^0 
^1 
kZ 
kZ 
kk 
kS 
kb 
k7 
kB 



connections currently established. The rows 
represent the S'* possible streams and the columns 
represent the 16 possible connections for a 
stream. True indicates an estabi ished connect ion, 
and false indicates the absence of a connection. 

LIST! This field contains the files currently connected 
to streams. The LNS descriptor of the file 
control block and the open file descriptor are 
maintained for each file connected together with a 
count indicating the number of streams to which 
the file is currently connected. 



13.1.i* IOC CHARACTER TRANSLATION TABLE - IOC#XLATE 

The definition of IOC#XLATE is as followsl 

IOC#XLATEt CXDCLl ARRAY CO. .255] OF CHAR; 

The default character translation set is the input 
character set. 



13.1.5 IOC TAB TABLE 



IOC#TAB 



The definition of IOC#TAB is as followsl 



I0C#TABI CXDCL] 
RECORD 

tchari char, " tab character " 
tposni array c 1. . 163 of 1..255, 
recend; 



TAB POSITIONS 



The default tab character is circumflex and the default 
tab positions are C5t 10, 15, 20, 25, 30, 35, ^0, ^5, 50, 
55, 60, 65, 70, 75, 80]. If the tab character is set to 
"space" no tabs will be acknowledged. 
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13.0 APPENDIX C ... INPUT/OUTPUT CONTROL (IOC) 
13.2 PROCEDURES 



13.1.6 HEX ESCAPE CHARACTER. - IOC#HEX 

The definition of IOC#HEX is as followsl 

ioc#HEX» [XOCL] char; 

The default hex escape character is reverse slant. If 
the hex escaoe character is set to "space" no hex escapes 
will be acknowledged. 



13.1.7 OS STATUS - OS#STATUS 



The definition of OS^STATUS is as followsl" 

TYPE 

OStfSTATUS = RECORD 

LEVELt 0..0FF(16), " general level indicator " 
from: string (2) of char, " issuing os section " 
ST^CODEl 0..0FFFF(16) , " specific status code " 
MESG: string (32) OF CHAR, " message mask " 

recend; 

LEVEL* This field contains the general status, the 
values of which are shown in the IPLOS structure 
overview document. 

FROMt This field contains the operating system section 
that issued the status. 

ST_CODEJ This field contains the specific status code 
issued . 

MESG: This field contains the message mask to be used 
by the system message generator when constructing 
diagnostic messages. 
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13.2 £E 



The following procedures may be called to obtain the 
services of IOC. 



13.2.1 OPEN INPUT - lOCi^OPEN 



The purpose of this procedure is to open a file for 
input. The file specified will become the current input 
file for the job. When a file is opened by this procedure 
its LNS descriptor is added to the input control stack and 
the file is physically opened for input. The calling 
sequence is as followst 

IOC#OPEN (file, status) 

filex This parameter specifies the LNS descriptor of 
the file to be opened. If the file specified does 
not exist an error condition will result. 

status! This parameter specifies the name of a variable 
into which the status is to be returned. 



13.2.2 CLOSE INPUT - IOC#CLOSE 

The purpose of this procedure is to close the current 
input file. When a file is closed by this procedure its LNS 
descriptor is removed from the input control stack and the 
file is physically closed. The calling sequence is as 
fo I lowst 

IOC#CLOSE (status) 

status! This parameter specifies the name of a variable 
into which the status is to be returned. 

NOTEl The standard input file cannot be closed by this 

NCR/CDC PRIVATE REV 75/05/27 
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13.0 APPENDIX C ... INPUT/OUTPUT CONTROL (IOC) 
13.2.5 GET FROM STANDARD INPUT - lOC^GETSTD 



procedure. 



13.2.3 GET POSITION - IOC#GETPOS 



The purpose of this procedure is to get the position of 
the current input file. The calling sequence is as follows! 

lOC^GETPOS (pos, status) 

pos: The pos parameter specifies the name of an integer 
variable into which the position is to be 
returned. The position returned is the position 
of the last record obtained from the file. 

statusi This parameter specifies the name of a variable 
into which the status is to be returned. 



13.2.4 SET POSITION - IOC#SETPOS 



The purpose of this procedure is to set the position of 
the current input file. The calling sequence is as followsi 

IOC#SETPOS (DOSf status) 

post The pos parameter specifies the position to which 
the file is to be set. 

status! This parameter specifies the name of a variable 
into which the status is to be returned. 
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13.2.5 GET FROM STANDARD INPUT - IOC#GETSTD 



The purpose of this procedure is to get the next record 
from the standard input file. The calling sequence is as 
fol I owss 

IOC#GETSTD (string, status) 

stringi The string parameter specifies the name of a 
string variable into which the record is to be 
returned. 

statusi This parameter specifies the name of a variable 
into which the status is to be returned. 

NOTEt Each record obtained from this procedure is 
translated character by character according to the 
character translation table. In addition each 
record is scanned for tab and hex escape 
characters. Subsequent to these operations each 
record is written to IOC#INPUT. 



13.2.6 GET FROM CURRENT INPUT - IOC#GET 



The purpose of this procedure is to get the next record 
from the current input file. The calling sequence is as 
fo i lows I 

IOC#GET (string, status) 

stringi The string parameter specifies the name of a 
string variable into which the record is to be 
returned. 

statusi This parameter specifies the name of a variable 
into which the status is to be returned. 

NOTEl Each record obtained from this procedure is 
written to lOC^ALTERNATE . 
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13.2.9 PUT TO STREAM - IQC#PUT 



13.2.7 CONNECT OUTPUT - IOC#CON 



The purpose of this procedure is to establish a 
connection between a file and a stream. When this procedure 
is called the map field of the stream connection table is 
altered and if necessary the LNS descriptor of the file 
specified is added to the table and the file is physically 
opened for output. The catling sequence is as followst 

IOC#CON (filet stream* status) 

fileJ This parameter specifies the LNS descriptor of 
the file to be connected. If the file specified 
does not exist an error condit ion Mi I 1 result. 

stream! This parameter specifies the LNS descriptor of 
the stream to be connected. 

statust This parameter specifies the name of a variable 
into which the status is to be returned. 



13.2.8 DISCONNECT OUTPUT - IOC#DISCON 



The purpose of this procedure is to sever the 
connection between a file and a stream. When this procedure 
is called the map field of the stream connectioi table is 
altered and if necessary the LNS descriptor Is removed from 
the table and the file Is physically closed. The calling 
sequence is as follows! 

IOC#OISCON (filet stream, status) 

filei This parameter specifies the LNS descriptor of 
the f i le to be disconnected. 

streami This parameter specifies the LNS descriptor of 
the stream to be disconnected. 

status: This parameter specifies the name of a variable 
into which the status is to be returned. 
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13.2.9 PUT TO STREAM - IOC#PUT 



The purpose of this procedure is to output a record. 
When a record is output by this procedure it is written on 
all files connected to the stream specified. The calling 
sequence is as fotlowsi 

lOC^PUT (stream, string, status) 

streami This parameter specifies the LNS descriptor of 
the stream to which the record is to be output. 

string: The string parameter specifies the string of 
text to be output. 

status: This parameter specifies the name of a variable 
into which the status is to be returned. 
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lif.O APPENDIX D ... MESSAGE GENERATOR 
1^.1 MESSAGE GENERATOR 



ENERATOR 



There will be a facility for the formatting and output 
of system messages from the IPL Operating System. 

The general requirements of such a system are roughly 
as foi I owsS 

o There sha.l I be a consistent method of calling for 
message output from the system.. 

o As far as possible all messages will be accessible 
from a central message file. 

o There should be a consistent format for messages. 
This will hsfve a side benefit in that users will 
grow accustomed to a consistent system of 
reporting. 

o The messages produced by the system should be 
amenable to analysis and data gathering by 
automatic means. 



ltf.0.1 FUNCTIONAL BREAKDOWN. 



The actual message system splits into two fairly 
distinct functional areas as follows. 



Message Generator. Provides the basis 
operating system response to the user. 



of 



Message File Update. Provides a meais of adding 
new status codes and message control strings to 
the system. 



1 
2 
3 
k 
5 
6 
7 
8 
9 
10 
11 
12 
13 
1^ 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
3t* 
35 
36 
37 
38 
39 
kQ 
41 
42 
43 
44 
45 
46 
47 
48 



14.1 



This program provides the basis for issuing messages to 

the user from the operating system. It is a fairly simple 

program both in conception and use. Its parameters are a 

stream descriptor specifying the stream to which output is 

to be sent and an OSffSTATUS record as defined below. 
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14.1.1 MESSAGE GENERATOR CALLING METHOD. 



The call upon the message generator passes two 
parameters* namely the descriptor of the stream to which 
output is to be sent and an OS#STATUS record as defined 
below. The section code and the specific status key from 
the OSJSfSTATUS record are used to look up an indexed 
sequential file to obtain a message control string. The 
level indicator in the status record plays no part in the 
lookup. 

the caller of the message generator will be responsible 
for deciding which streams the message should be output to* 
since it can only be the caller who is aware of the 
significance of the status. 

The macro call format is as follows* 
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lit.O APPENDIX D ... MESSAGE GENERATOR 
1^.1.3 CONTROL OF OUTPUT DETAIL LEVEL. 



MG#REPORT{ stream , status ) 

stream t this parameter is the descriptor of the stream 
to which the message is to be sent. 

status : this parameter is an OS#STATUS record as 
defined below. 



14.1.2 CONTROL CHARACTERS. 



As previously mentioned, the first character of the 
message control string should be a delimiter^ which will be 
subsequently used to indicate control information. The 
control character and the character immediate! y fo I lowing it 
represent different actions that the message generator can 
perform with the message masK. The possible control 
sequences currently available are as follows. ( + wi I I 
represent the control character ). 

<-P Take the next delimited sequence from the message 
masK in the status record and insert it into the 
output text. 

+N Insert a newl ine character into the output text at 
this point. 



14.1.3 CONTROL OF OUTPUT DETAIL LEVEL. 



When the message generator is called, there can be a 
certain degree of control over the amount of detail supplied 
in the message. This can be controlled by setting the LNS 
variable LNS#LOCAL->MG#HEAD to a particular value. There 
are at present three possible settings of the variable 
giving three types of output in varying amounts of detail as 
f o i I ows. 



MGf/HEAD = 1 
Engl ish". 



t The message will be output in "plain 
The message mask will be formatted 
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according to the message control string in the 
message file. This mode of the message generator 
will be considered the normal; any setting of 
MG#HEAD which is outside the permissible range of 
settings will cause the head style to be defaulted 
to head sty I e 1. 

HG#HEAD = 2 : output only the status code and the 
message mask. The message generator will not look 
for the message control string to pertorm any 
replacement of the message mask. 

MGSHEAD = 3 t This setting of the switch will output 
the most detail, consisting of the OS section 
name, accepted/rejected state and the message 
itself. 

Example I Suppose the OS#STATUS record contains the 
following information. 

status code = 8LN0205 

message mask = • ♦VERMOUTH»MARTINI*' 

Message generator will use the key LN0205 to look up 
the indexed sequential file of message control strings. 
Suppose the message control string corresponding to the key 
LN0205 is J 

message control string = •+ENTRY +P NOT FOUND IN SEGMENT 
+P* . 



MG#HEAD = 1 will output t 

8LN0205 ENTRY VERMOUTH NOT FOUND IN SEGMENT MARTINI 

MG#HEAD = 2 wi 1 I output I 
3LN0205 »VERMOUTH»MARTINI* 

MG^HEAD = 3 will output I 



REQUEST REJECTED DUE TO USER PROBLEM. 

ERROR 0205 DETECTED BY LNS MANAGER. 

ENTRY VERMOUTH NOT FOUND IN SEGMENT MARTINI 
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14.0 APPENDIX D ... MESSAGE GENERATOR 
14.2.1 MGi^EDIT 



14.2 M£SSA££-^Ji.E_UPIlAIE 



This orogram will accept input consisting of a status 
code and the corresponding control string. It will make 
cnecks on the prior existence of that code and will enter or 
update the new data into the indexed sequential file of 
message control strings for use by the message generator. 

To assist in maintaining the file of message control 
strings the message generator has the following commands. 
Note that the use of these commands will be restricted to 
systems personnel and will not be available to the casual 

user. 



14.2.1 MG#EDIT 



The purpose of this command is to edit the file of 
message control strings* either to insert new entries or to 
change or delete old entries. The format of the command is 
as foil ows. 

MG#EDIT section=<string> £ code=< integer> J Cmessage=<str 
[new] Cold] [delete] [status=<ref name>1 

section I s t This parameter is the abbreviation for 
the OS section name which is responsible for 
generating thef specific status concerned. 



code I c I This parameter is 
the actual status code. 



an integer representing 



message I m : This parameter is a character string 
representing the message control string for that 
particular status code. 

new f old I delete t This parameter specifies the 
current status of the entry in the message control 
file. Quoting "new" indicates that this is a new 
entry; "old" indicates that this entry will 
replace an already existing entry; "delete" 
indicates that an existing entry is to be 
deleted. If "delete" is quoted then the 'message* 
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parameter in the command is redundant and need not 
be specified. 

status I This parameter represents an LNS variable into 
which the status of the request will be returned 
on completion of the command. If the 'status* 
parameter is not specified then the SCL error 
handler will be invoked upon detection of any 
error condition. 

Example of use i 

MG#EOIT section = 'LN* code = 0205 new,.... 

message = '^-ENTRY +P NOT FOUND IN SEGMENT ♦P- 



Notes on the MG#EDIT Command. 

1. Note that all entries in a particular section of 
the message control file may be deleted by typing the 
command in the form s 



MG#EDIT 



section='XX' 



delete 



2. Also the whole message control file may be deleted 
by simply typing the command in the form I 

MG#EDIT delete 

Extreme care should be exercised in using these 
variants of the command. 

Also see the MG^SECT command belowt where there is a 
relationship between the entries in the MG#NAMELIST and the 
entries in the message control file. 



14.2.2 MG#SECT 



The purpose of this command is to associate a section 
abbreviation with the full name of the section* for example 
•LN" is associated with 'LNS MANAGER". The format of the 
command is as follows. 
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Ik.Q APPEMDIX D .. 
1^.2.2 MG#SECT 



MESSAGE GENERATOR 



MG#SECT section=<string> name=<string> Cnewl Cold] tdeletel 

section J s t This parameter is the abbreviation for 
the OS section. 

name 5 n t This parameter is a string representing the 
full name of the OS section concerned. 



I old t 



delete t This parameter indicates the 
current status of the entry in question. ^^o^^^?, 
"new" indicates that this is a new entry, old 
indicates that this is a replacement of an 
existing entry; "delete" indicates that the 
specified entry is to be deleted. If 'delete is 
quoted the "name" parameter is redundant and need 
not be quoted. 

Example of use t 
MGtfSECT section='LN' name=*LNS MANAGER' new 



Notes on the command. 

1. The MG#SECT command can be typed in the following 



manner : 



section=*XX' 



delete 



If the command is typed in this way then as well as 
deleting the entry in the namelist table, all entries 
belonging to that OS section in the message control file 
will also be deleted. Care should be exercised in the use 
of this variant of the command. 



1^.2.3 MG#DISPLAY 

The purpose of this command is to provide listings of 
the entries currently on the message control file. All 
entries in the file may be listed, or Just those 
appertaining to a specific section of OS. The format of the 
command is as follows. 
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MG#DISPLAY Csection=<string>l [code=<integer> ] 

section I s t This parameter is the abbreviation for 
the particular OS section if only the codes for 
that section are required to be listed. 

code I c I This parameter is quoted when the data 
relating to a specific code is required. If this 
parameter is quoted then the 'section* parameter 
must also be quoted. 

Note that if the MG#DISPLAY command is typed with no 
parameters at all then all the entries in the file will be 
listed. 

Example of use : 

MG#DISPLAY. section='LN' 
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1^.3 DATA STRUCTURES 



1^.3 aA 



1*».3.1 OS STATUS - OS#STATUS 



The definition ot OS#STATUS is as foilowst 

TYPE 

OS#STATUS = RECORD 

level: 0..0FF(16), " general level indicator" 
FROMI STRING (2) OF CHAR, " issuing OS section " 
ST_C0DE: 0..0FFFF(16) , " specific status code " 
MESGt STRING(32) OF CHAR, " message mask " . 

recend; 

LEVELI This field contains the general status, the 
values of which are shown in the IPLOS structure 
overview document. 

FROMl This field contains the operating system section 
that issued the status. 

ST_COOEi This field contains the specific status code 
issued. 

MESGi This field contains the message mask to be used 
by the system message generator when constructing 
diagnostic messages. 



i^.3.2 OS SECTION NAME LIST. 



The message generator system will require a list of OS 
section names to be maintained in LNS#GLOBAL in order that 
the section abbreviation may be converted to the appropriate 
character string when the full section name is required. 
The SWL type definition of this structure is as follows. 
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14.0 APPENDIX ... MESSAGE GENERATOR 
14.3.2 OS SECTION NAME LIST. 



MG#NAMELIST = 
ARRAYi 1 .. 
RECORD 

SECTION I STRINGC 
NAME 
RECEND 



] OF 



2 ) OF CHAR , 
I STRINGC 32 ) OF CHAR 



OS Section Mnemonic 
OS Section Name " 
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